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Preface 


This manual provides reference material for using the CDA (Compound Document 
Architecture) Toolkit to create compound document applications, converters, and 
viewer widgets. Information in this manual includes reference material for using 
the DDIF (DIGITAL Document Interchange Format) and DTIF (DIGITAL Table 
Interchange Format) aggregates that are processed by the CDA Toolkit routines. 


The CDA Toolkit is a collection of data structures and routines that support the 
creation of CDA applications. The CDA Converter architecture is used to convert 
files of a specified input format to a specified output format. The CDA Viewer 

is used to display CDA-encoded files on a workstation display or character cell 
terminal. 


CDA is supported in both the VMS and the ULTRIX environments. The informa- 
tion contained in this manual is appropriate for both systems. Any differences 
between the two implementations are called out in the text of this manual. 


All of the following products support CDA-encoded files. If you intend to manip- 
ulate only DDIF files and do not have an interest in the particulars of the file 
format, you can use any one of these products to manipulate a CDA-encoded file. 


DECpaint _ PrintScreen CardFiler 

DEC GKS DEC GKS-3D PHIGS 

CDA Viewer DECwindows MAIL DECImage Applications 
Services 

Converters MAIL DECwrite 

DECchart DECdecision ' DEC Test Manager 


Intended Audience 


This manual is intended for system and application programmers who already 
have been introduced to CDA and who are ready to use the CDA Toolkit to write 
compound document applications, converters, or viewers. Some knowledge of the 
tasks and terminology associated with document typesetting is helpful. 


Document Structure 


This manual consists of 13 chapters, several appendixes, and a glossary, as 
follows: 


e Chapter 1, Introduction provides an introduction to the reference material 
describing the aggregates and routines contained in the CDA Toolkit. 


xvii 


xviii 


Chapter 2, Bundled Converter Formats and Commands describes the VMS 
and ULTRIX converter formats and commands used to convert and to view 
CDA documents. 


Chapter 3, Transferring CDA Documents describes how to mail and to copy 
CDA documents on VMS and ULTRIX systems. 


Chapter 4, DDIF Structures describes each of the DDIF aggregate structures. 
Chapter 5, DTIF Structures describes each of the DTIF aggregate structures. 
Chapter 6, CFE Structures describes each of the CFE aggregate structures. 
Chapter 7, ESF Structures describes each of the ESF aggregate structures. 


Chapter 8, CDA Toolkit Routines describes each of the routines contained 
in the CDA Toolkit. The routines are documented in alphabetical order. 
Each routine description specifies the calling format, the encoding of the 
parameters, a detailed description of the function of the routine, and what 
condition values the routine can return. 


Chapter 9, User-Defined Routines describes the user-defined routines used to 
write CDA-conforming applications and front and back ends. 


Chapter 10, CDA Toolkit Example Program contains an example program 
that uses the CDA Toolkit to create a DDIF file, and an illustration of the file 
created by the example program. 


Chapter 11, CDA Converter Routines describes each of the converter routines 
that must be created in order to write a CDA-conforming front or back end. 


Chapter 12, Text Front End Source File contains the source code for the Text 
front end to be used as an example for those wanting to develop their own 
front or back ends. 


Chapter 18, CDA Viewer Routines describes each of the viewer routines used 
to create a character-cell or DECwindows viewer application. 


Appendix A, DDIF Fill Patterns illustrates the CDA-defined fill patterns. 


Appendix B, DDIF Syntax Diagrams contains a brief overview of DDIS 
(DIGITAL Data Interchange Syntax) followed by the syntax diagrams for the 
various constructs supported by the DDIF architecture. 


Appendix C, DTIF Syntax Diagrams contains the syntax diagrams for the 
various constructs supported by DTIF. 


Appendix D, CFE Syntax Diagrams contains the syntax diagrams for the 
various constructs supported by CFE. 


Appendix E, ESF Syntax Diagrams contains the syntax diagrams for the 
various constructs supported by ESF. 


Appendix F, VMS Support for CDA in DECwindows discusses the support 
provided by VMS for the CDA Toolkit and the tagging of DDIF-encoded files. 


Appendix G, CDA$ Facility Messages lists and describes the CDA$_ facility 
messages generated by the CDA Toolkit. 


Glossary, Glossary of Terms defines the terminology associated with the CDA 
Toolkit and CDA Converter Architecture. 


Associated Documents 


CDA is supported by a variety of DIGITAL products. Descriptions of the support 
provided by each product are contained in that product’s documentation. For 
example, GKS support for CDA is described in the GKS documentation set, and 
SO on. 


The complete CDA documentation set includes two tutorials and a reference 
manual: 


¢ Introduction to the CDA Services 
¢ Guide to Creating Compound Documents with the CDA Toolkit 
e CDA Reference Manual 


The CDA documentation set is a separately orderable subkit available for pur- 
chase with the VMS and ULTRIX operating system documentation.. Each manual 
in the CDA documentation set is also available for separate purchase. 


The CDA Converter Library end-user documentation set describes additional 
document, graphics, image, and table data file formats that are supported by the 
CDA Converter architecture, but that are not bundled with the VMS or ULTRIX 
operating system. The following two manuals describe the additional interchange 
formats: 


¢ Guide to the CDA Converter Library 
¢ Getting Started with the CDA Converter Library 


Conventions 


The following conventions are used in this manual: 


Ctrl/x A sequence such as Ctrl/x indicates that you must hold 
down the key labeled Ctrl while you press another key 
or a pointing device button. 


PF1 x A sequence such as PF1 x indicates that you must first 
press and release the key labeled PF1, then press and 
release another key or a pointing device button. 


A key name is shown enclosed to indicate that you 
press a key on the keyboard. 


In examples, a horizontal ellipsis indicates one of the 
following possibilities: 


e Additional optional arguments in a statement 
have been omitted. 

e The preceding item or items can be repeated one 
or more times. 

e Additional parameters, values, or other informa- 
tion can be entered. 


A vertical ellipsis indicates the omission of items from 
a code example or command format; the items are 
omitted because they are not important to the topic 
being discussed. 


xix 


XX 


it 


red ink 


italic text 


italic text 


boldface text 


UPPERCASE TEXT 


UPPERCASE TEXT 


lowercase text 


numbers 


In format descriptions, parentheses indicate that, if 
you choose more than one option, you must enclose the 
choices in parentheses. 


In format descriptions, brackets indicate that whatever 
is enclosed is optional; you can select none, one, or all 
of the choices. 


In format descriptions, braces surround a required 
choice of options; you must choose one of the options 
listed. 


Red ink indicates information that you must enter 
from the keyboard or a screen object that you must 
choose or click on. For online manuals, user input is 
specified in bold. 


Italic text represents the introduction of a new term or 
the name of an argument, an attribute, or a reason. 


Italic text represents user-written routines (for exam- 
ple, get-aggregate). 


Boldface text represents information that can vary 
in system messages (for example, Internal error 
number). 


Uppercase letters indicate that you must enter a 
command (for example, enter OPEN/READ). 


Uppercase letters indicate the name of a CDA Toolkit 
routine, the name of a file, the name of a file protection 
code, or the abbreviation for a system privilege. 


Lowercase letters indicate the names of the CDA 
Toolkit VAX format routines and values that are 
portable to ULTRIX systems. Value names that appear 
in lowercase must be coded as such in order to be 
portable to ULTRIX systems. 


Hyphens in coding examples indicate that additional 
arguments to the request are provided on the line that 
follows. 


Unless otherwise noted, all numbers in the text are 
assumed to be decimal. Nondecimal radixes—binary, 
octal, or hexadecimal—are explicitly indicated in the 
coding examples. 


Chapter 8 
CDA Toolkit Routines 


This section describes the CDA Toolkit routines and VMS and ULTRIX compile — 
and link procedures used to create CDA-conforming applications. Each routine 
description includes the following information: 


e A common language (VAX) style binding that is supported on both VMS and 
ULTRIX systems 


e An ULTRIX C style binding that is supported on both VMS and ULTRIX 
systems 


¢ A description of the value returned by the routine 
e Descriptions of each routine argument 
e A description of the routine itself 


e A list of possible values returned by the routine 


NOTE 


Given the bindings available at this time, there are two ways to create 
CDA Toolkit applications that are portable across VMS and ULTRIX 
systems: 


1. Code using C style bindings by matching mix-cased spelling. 


2. Code your source in lowercase if using the VAX formats (as the 
bindings are lowercase in the current ULTRIX CDA Toolkit). 


If you are programming in Ada, please refer to the Guide to Applications 
Programming for information on Ada programming with DECwindows. 


8.1 Compile and Link Procedures for Applications 


To create a VMS or ULTRIX application using the CDA Toolkit routines, include 
the following public files in your source code: 


VMS and ULTRIX 

File Names Description 
SYS$LIBRARY:cda$def.h CDA Toolkit keyword definitions 
/usr/include/cda_def.h 

SYS$LIBRARY:ddif$def.h DDIF aggregate definitions 


/usr/include/ddif_def.h 
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VMS and ULTRIX 


File Names Description 
SYS$LIBRARY:dtif$def.h DTIF aggregate definitions 
/asr/include/dtif_def.h 

SYS$LIBRARY:cda$msg.h CDA error messages 


_ /asr/include/cda_msg.h 


NOTE 


If you are programming in Ada, please refer to the Guide to 
Applications Programming for information on Ada programming 
with DECwindows. 


Section 8.1.1 describes the VMS compile and link procedure for CDA applications. 
Section 8.1.2 describes the ULTRIX compile and link procedure for CDA 
applications. 


8.1.1 VMS Link Procedure 


You can compile and link a CDA application on VMS using the following build 
procedure that also incorporates debugging: 


$§ cc /DEBUG MY APPLICATION 
$ LINK /DEBUG MY_APPLICATION, SYSSINPUT: /OPTION 
SYSSLIBRARY : CDASACCESS/ SHARE 


8.1.2 ULTRIX Link Procedure 


You can compile and link an application on ULTRIX using the following build 
procedure: 


fe} 


% cc -o my_application my_application.c -lddif —1m 


The -lm parameter specifies the math library that is required by the CDA Toolkit 
routines (-lddif). 
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AGGREGATE TYPE TO OBJECT ID 


AGGREGATE TYPE TO OBJECT ID 


Translates a root aggregate type to an object identifier. 


VAX FORMAT | 
status = cda$aggregate_type_to_ object_id 
(aggregate-type ,buf-len ,buf-adr ,znam-len ,nam-buf 
,act-nam-len ,act-len) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

aggregate-type VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

buf-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

buf-adr VMS usage: array 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference, array reference 

nam-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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AGGREGATE TYPE TO OBJECT ID 


Argument Argument Information 

nam-buf VMS usage: array 
Data type: character string 
Access: write only 
Mechanism: by reference, array reference 

act-nam-len ‘VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

act-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 
status = CdaAggregateTypeToObjectid 


(aggregate_type, buf_len, buf_adr, nam_len, 
nam_buf, act_nam_len, act_len) 


Argument Information 


unsigned long CdaAggregateTypeToObjectId(aggregate_type, 
buf_len, buf_adr, nam_len, 
nam_ buf, act_nam_len, act_len) 


unsigned long aggregate _ type; 
unsigned long buf_len; 
unsigned long _ buf_adr[]; 
unsigned long nam_len; 
unsigned char nam_buf[]; 
unsigned long *act_nam_len; 
unsigned long *act_len; 


RETURNS 


Status 
A condition value indicating the return status of the routine call. 


8-4 CDA Toolkit Routines 


Arguments 


AGGREGATE TYPE TO OBJECT ID 


aggregate-type 
Type of the aggregate being translated. The root aggregate type must be either 
DDIF$_DDF or DTIF$_DTF. 


buf-len 
Length (in bytes) of the object identifier buffer. Length must be at least 28 bytes 
(space for 7 longwords). 


buf-adr 
An array of longwords to receive the object identifier. 


nam-len 
Length (in bytes) of the domain name buffer. 


nam-buf 
Address of the domain name buffer to receive a string of characters. 


act-nam-len 


_ Receives the actual length (in bytes) of the domain name in the nam-buf buffer. 


Description 


act-len 
Receives the actual length (in bytes) of the object identifier. 


The AGGREGATE TYPE TO OBJECT ID routine translates a root aggregate type 
to an object identifier. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 
CDA$_INVBUFLEN Invalid buffer length 
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CLOSE FILE 


CLOSE FILE 


Closes the specified compound document file and stream. If the file being closed 
was receiving output, the CLOSE FILE routine writes any buffered data before 


closing the file and stream. 


VAX FORMAT 


status = cda$close_file 


Argument Information 


Argument 


status 


stream-handle 


file-handle 


C FORMAT 


status = CdaCloseFile 
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(stream-hanale ,file-handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


(stream_handle, file_handle) 


CLOSE FILE 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaCloseFile (stream handle, 
file handle) 
unsigned long stream_handle; 
unsigned long file handle; 


status 
A condition value indicating the return status of the routine call. 


stream-handle 
Handle of the stream to be closed. This handle is returned by a call to either the 
OPEN FILE routine or the CREATE FILE routine. 


file-handle 
Handle of the file to be closed. This handle is returned by a call to either the 
OPEN FILE routine or the CREATE FILE routine. 


The CLOSE FILE routine closes the specified stream and compound document 
file. If the file being closed was receiving output, this routine writes out any 
buffered data before closing the stream. Note that the stream-handle and 
file-handle values are invalid after a call to this routine. 


RETURN VALUES 


Return Value Description 
CDA$_ NORMAL Normal successful completion‘ 


Any error returned by the memory deallocation routines. 


Any error returned by the file routines. 
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CLOSE FILE 


Example 


This example illustrates a typical call to the CLOSE FILE routine. The entire 
document is written to the output file prior to a call to the CLOSE FILE routine. 
After the file has been closed, the document root aggregate is deleted. 
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/* output to a DDIF file */ 
printf("Writing document...\n"); 


status = cda$put_document (&root_aggregate_ handle, 
&stream_handle) ; 
if (FAILURE (status)) return(status); 


status = cda$close file(&stream_handle, &file_handle); 
if (FAILURE (status)) return(status) ; 


status = cda$delete_root_aggregate(&root_aggregate_handle) ; 
if (FAILURE (status)) return(status); 


CLOSE STREAM 


Closes an open compound document stream. 


VAX FORMAT 
status = cda$close_stream 


(stream-handle) 


Argument Information 


CLOSE STREAM 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

stream-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


C FORMAT 
status = CdaCloseStream 


(stream_handle) 


Argument Information 


unsigned long CdaCloseStream(stream_handle) 


unsigned long stream_handle; 
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CLOSE STREAM 


RETURNS 
status 
A condition value indicating the return status of the routine call. 
Argument 
stream-handle 
Handle of the stream to be closed. This handle is returned by a call to either the 
OPEN STREAM routine or the CREATE STREAM routine. 
Description 


The CLOSE STREAM routine closes an open compound document stream. If the 
stream being closed was receiving output, the CLOSE STREAM routine writes 
out any buffered data before closing the stream. Note that the stream-handle 
argument is invalid after a call to this routine. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 


Any error returned by the memory deallocation routines. 
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CLOSE TEXT FILE 


Closes a text file. 


VAX FORMAT 
status = cda$close_text_file 
_ (text-file-handle) 


Argument Information 


CLOSE TEXT FILE 


Argument Argument Information 


status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
text-file-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: 


C FORMAT 
status = CdaCloseTextFile 


(text_file_handle) 


Argument Information 


by reference 


unsigned long CdaCloseTextFile (text _file handle) 
unsigned long text file handle; 
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CLOSE TEXT FILE 


RETURNS 


Argument 


Description 


status 
A condition value indicating the return status of the routine call 


text-file-handle 
Identifier of the text file to be closed. This handle is returned by a call to either 
the CREATE TEXT FILE routine or the OPEN TEXT FILE routine. 


The CLOSE TEXT FILE routine closes a text file. The text-file-handle is invalid 
after a call to this routine. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


Any error returned by the memory deallocation routines. 


Any error returned by the file routines. 


8-12 CDA Toolkit Routines 


CONVERT 


CONVERT 


Lets the user perform document conversion from within an application. This 
includes beginning, continuing, or discontinuing the conversion of a document. 


VAX FORMAT 
status = cda$convert 


(function-code ,standard-item-list ,private-item-list 


,converter-context) 
Argument Information 
Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
function-code VMS usage: - longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
standard-item-list VMS usage: item_list_2 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference, array reference 
private-item-list VMS usage: unspecified 
Data type: unspecified 
Access: read only 
Mechanism: by reference 
converter-context VMS usage: context 
Data type: longword (unsigned) 
Access: read only or write only 
Mechanism: by reference 
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CONVERT 


C FORMAT 
status = CdaConvert 


(function_code, standard_item_list, 
private_item_list, converter_context) 


Argument Information 


unsigned long CdaConvert (function_code, standard_item_list, 
private _item_list, converter _context) 


unsigned long function_code; 

unsigned long *standard_item_list; 
unsigned char *private_item_list; 
unsigned long *converter_ context; 


RETURNS 


Status 
A condition value indicating the return status of the routine call. 


Arguments 


function-code 

Symbolic constant that identifies the function to be performed. These symbolic 
constant values are defined in the file cda$def.h on VMS systems and in the file 
cda_def.h on ULTRIX systems. Valid values are as follows: 


CDA$_START 
Start conversion. This function code must be specified to begin a document 
conversion. 


CDA$_CONTINUE 

Continue a conversion that was suspended. This function code may only 

be specified if a previous call to the CONVERT routine returned the value 
CDA$_SUSPEND. If CDA$_SUSPEND is returned by a call to the CONVERT 
routine, either CDA$_ CONTINUE or CDA$_STOP must be specified so that 
resources locked by the conversion are released. 


CDA$_STOP 

Discontinue a conversion that was suspended. This function code may only 
be specified if the previous call to the CONVERT routine returned the value 
CDA$_SUSPEND. If CDA$_SUSPEND is returned by a call to the CONVERT 
routine, either CDA$_STOP or CDA$_CONTINUE must be specified so that 
resources locked by the conversion are released. 
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CONVERT 


standard-item-list 
An item list that identifies the document source and destination, and can also 
contain options to control processing. 


Each entry in the item list is a 2-longword structure with the following format: 


buffer address 





To terminate the item list, you must specify the final entry or longword as 0. 
The standard-item-list argument is only valid when function-code is set to 
CDA$_START; otherwise, standard-item-list is ignored. Valid code values for 
the items in the standard-item-list are as follows: 


CDA$_INPUT_FORMAT 
The parameter is the address and length of a string that specifies the input 
document format. 


CDA$_INPUT_FRONT_END_PROCEDURE 
The parameter is the address of the main entry point for the front end. 


The item-list length field for this item must be set to 0. This item enables a 
caller to provide a front end that is a routine within the calling application 
rather than a separate image. If this item code is used, the CDA$_INPUT_ 
FILE item can be used to pass any information (not necessarily a file 
specification) to the front end. 


CDA$_INPUT_FRONT_END_DOMAIN 

The parameter is the address and length of a string that specifies the input 
document domain (either DDIF or DTIF). This item is used with the CDA$_ 
INPUT_PROCEDURE item to denote the input domain. 


CDA$_INPUT_FILE 
The parameter is the address and length of the file specification of the input 
document. 


CDA$_INPUT_DEFAULT 

The parameter is the address and length of a string that specifies the default 
input file type. To simplify the porting of applications to other operating 
systems, the string should consist only of a file type in lowercase characters. 
If this parameter is omitted, the front end will supply an appropriate backup 
default file specification. 


CDA$_INPUT_PROCEDURE 

The parameter is the address of a procedure to provide input to the front end. 
The item-list length field must be set to 0. The input procedure must conform 
to the requirements for a user get routine. The calling sequence for a user get 
routine is defined in Chapter 9. 
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CONVERT 


CDA$_INPUT_PROCEDURE_PARM 

The parameter is the address of a longword parameter to the input procedure. 
The item-list length field must be set to 4. This item is valid only if the 
CDA$_INPUT_PROCEDURE value is specified 


CDA$_INPUT_POSITION_PROCEDURE 

The parameter is the address of a procedure that provides position informa- 
tion. The item-list length field must be set to 0. The position procedure must 
conform to the requirements for a user get-position routine. The get-position 
procedure is specified in the description of the OPEN CONVERTER routine. 


CDA$_INPUT_ROOT_AGGREGATE 

The parameter is the address of a longword root aggregate handle that 
specifies an in-memory input document. The item-list length field must be set 
to 4. The entire in-memory structure, including the root aggregate itself, is 
erased by this operation. Note that the root aggregate must specify standard 
memory allocation. 


CDA$_OUTPUT_FORMAT 
The parameter is the address and length of a string that specifies the output 
document format. 


CDA$_OUTPUT_BACK_END_PROCEDURE 
The parameter is the address of the main entry point of the back end. 


The item-list length field must be set to 0. This item enables a caller to 
provide a back end that is part of the calling application rather than a 
separate image. If this item code is used, the CDA$_ OUTPUT_FILE item can 
be used to pass any information (not necessarily a file specification) to the 
back end. 


CDA$_OUTPUT_BACK_END_DOMAIN 

The parameter is the address and length of a string that specifies the output 
document domain (either DDIF or DTIF). This item is used with the CDA$_ 
OUTPUT_PROCEDURE item to denote the output domain. 


CDA$_OUTPUT_FILE 
The parameter is the address and length of the file specification of the output 
document. 


CDA$_OUTPUT_DEFAULT 

The parameter is the address and length of a string that specifies the default 
output file type. To simplify the porting of applications to other operating 
systems, the string should consist only of a file type in lowercase characters. 
If this parameter is omitted, the back end will supply an appropriate backup 
default file specification. 


CDA$_OUTPUT_PROCEDURE 

The parameter is the address of a procedure to receive output. The item-list 
length field must be set to 0. The output procedure must conform to the 
requirements for a user put routine. The calling sequence for a user put 
routine is defined in Chapter 9. 
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CONVERT 


CDA$_OUTPUT_PROCEDURE_PARM 

The parameter is the address of a longword parameter to the output proce- 
dure. The item-list length field must be set to 4. This item is valid only if the 
CDA$_OUTPUT_PROCEDURE item is specified. 


CDA$_OUTPUT_PROCEDURE_BUFFER 

The parameter is the address and length of the initial output buffer for 
the output procedure. This item is valid only if the CDA$_OUTPUT_ 
PROCEDURE item is specified. 


CDA$_OUTPUT_ROOT_AGGREGATE 

The parameter is the address of a longword root aggregate handle that 
receives an in-memory output document. The item-list length field must 
be set to 4. The root aggregate must be empty, and must specify standard 
memory allocation. This root aggregate contains an entire in-memory 
document at the end of the conversion. 


CDA$_OPTIONS_FILE 

The parameter is the address and length of the file specification of an options 
file that contains options to control processing. The default file type is 
CDA$OPTIONS on VMS systems and cda_options on ULTRIX systems. Each 
line of the file specifies a format name that can contain upper- and lowercase 
alphabetic characters, digits, dollar signs, and underscores, optionally 
preceded by spaces and tabs, and terminated by any character other than 
those listed. Alphabetic case is not significant. The syntax and interpretation 
of the text that follows the format name are specified by the supplier of the 
front and back ends for the specified format. Multiple lines that specify the 
same format are permitted. 


CDA$_OPTIONS_LINE 

The parameter is the address and length of a string that contains options to 
control processing. The format of each string is defined in the description of 
the CDA$ OPTIONS _FILE item code. 


private-item-list 

A private item list that is passed directly to the output converter module that is 
invoked. The specification of this item list is the responsibility of the particular 
back end. Its purpose is to provide for direct two-way communication between 
the caller of the CONVERT routine and the back end. On ULTRIX systems, the 
CDA$_OUTPUT_BACK_END_PROCEDURE item must be specified when this 
parameter is used. 


converter-context 

If function-code is set to CDA$_ START, this argument receives a value that 
must be specified as the converter-context parameter when the CONVERT 
routine is called with CDA$ CONTINUE or CDA$_ STOP as the function code. 
This value is invalidated when the CONVERT routine returns a status other than 
CDA$_SUSPEND. This parameter is used by the back end to store its processing 
context. 
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CONVERT 


Description 


The CONVERT routine lets you perform document conversion from within an 
application. This includes beginning, continuing, or discontinuing the conversion 
of a document. 


To specify the input and output information, and any processing options files, 
you should construct an item list with the appropriate fields as specified in the . 
description of the standard-item-list argument. Note that the standard-item- 
list argument is only valid when function-code is set to CDA$_START. The 
following restrictions apply when you are constructing the standard-item-list: 


Either the CDA$ INPUT_FORMAT item or the CDA$_INPUT_FRONT_ 
END_PROCEDURE item, but not both, can be specified once in the item list. 
If neither is specified, the default input format is DDIF. 


Either the CDA$_INPUT_FILE item, the CDA$_ INPUT_PROCEDURE item, 
or the CDA$_INPUT_ROOT_AGGREGATE item must be specified once in the 
item list. If the CDA$_INPUT_PROCEDURE item is specified, the CDA$_ 
INPUT_PROCEDURE_PARM item can also be specified once. 


Either the CDA$_OUTPUT_FORMAT item or the CDA$_OUTPUT_BACK_ 
END_PROCEDURE item, but not both, can be specified once in the item list. 
If neither is specified, the default output format is DDIF. 


Either the CDA$_OUTPUT_FILE item, the CDA$_OUTPUT_PROCEDURE 
item, or the CDA$_OUTPUT_ROOT_AGGREGATE item must be specified 
once in the item list. If the CDA$_OUTPUT_PROCEDURE item is specified, 


_ the CDA$_OUTPUT_PROCEDURE_PARM item and the CDA$_OUTPUT_ 


PROCEDURE_BUFFER item can each be specified once. 
The CDA$_OPTIONS_FILE item can only be specified once in the item list. 


The CDA$_OPTIONS_LINE item can be specified multiple times in the item 
list. 
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RETURN VALUES 


Return Value 


CDA$_DCVNOTFND 
CDA$_ICVNOTFND 
CDA$_INVFUNCOD 
CDA$_INVINPDMN 
CDA$_INVITMLST 
CDA$_INVOUTDMN 
CDA$_NORMAL 
CDA$_OCVNOTFND 
CDA$_SUSPEND 
CDA$_UNSUPCNV 
CDA$_UNSUPFMT 


CONVERT 


Description 

Domain converter not found. 
Input converter not found. 
Invalid function code. 
Invalid input domain. 
Invalid item list. 

Invalid output domain. 
Normal successful completion. 
Output converter not found. 
Converter is suspended. 
Unsupported conversion. 


Unsupported document format. 


Example 


Any error conditions returned by the specific front end. 


Any error conditions returned by the specific back end. 


This example illustrates the use of the CONVERT routine to invoke the DDIF 


and Text converters. 


/* Example text to ddif conversion using callable converter interface 


* with a user-supplied get-rtn for text input. 


ay. 


#ifdef vms 

#include <cdaSdef.h> 
#include <cda$msg.h> 
#include <fab.h> 
#include <rab.h> 
#include <rmsdef.h> 
#else 

#include <cda_def.h> 
#include <cda_msg.h> 
#include <sys/file.h> 
#include <stdio.h> 
fendif 


#define FAILURE (x) (((x) & 1) == 0) 
#define text_ubf_ size 2048 
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/* User-supplied get-prm 

*/ 

#ifdef vms 

struct FAB 

struct RAB 

#else 

struct urab { 
int fd; 
FILE *fs; 
unsigned char *fil_ buffer; 
unsigned long fil_buflen; 
unsigned long fil_size; 

}; 

struct urab text rab; 

extern char *fgets(); 

#endif 

unsigned char 


text_fab; 
text. rab; 


char 
long 


static unsigned 
static unsigned 


static unsigned 


/* 
/* 
/* 
/* 
/* 


ddif format [] 
ddif format_length = 


char text_format[] 


file descriptor Pf 

file ptr, used for text files */ 
address of input buffer */ 
length of input buffer */ 

size of file */ 


text_ubf[text_ubf_ size]; 


"DDIE"; 
sizeof(ddif format) - 1; 


"TEXT" ; 


static unsigned long text_format_length = sizeof(text_format) - 1; 
static unsigned char text_file[] = "text"; 

static unsigned long text_file length = sizeof(text_file) - 1; 
static unsigned char text. default[] =. “.txt"; 


static unsigned 


Long ext -detault length: = 


sizeof (text_default) - 1; 


static unsigned char ddif_file[] = "output"; 

static unsigned long ddif file length = sizeof(ddif_ file) - 1; 
static unsigned char ddif_default[] = ".ddif"; 

static unsigned long ddif default_length = sizeof(ddif_default) - 1; 


/* User-supplied get-rtn 
ats 


unsigned long input_text_procedure(get_prm, num_bytes, buf_adr) 


#ifdef vms 
struct RAB 
#else 

struct urab 
#fendif 
unsigned long 
unsigned char 


{ 


#ifdef vms 
unsigned long 


*Get prim; 
*get_prm; 


*num_bytes; 
**buf adr; 


status; 


status = 
if (FAILURE (status) ) 
{ 


sys$get (get_prm) ; 


if (status == RMSS$ EOF) 


status = 
return status; 

} 
*num bytes = 
‘bul adi = 
return status; 


#else 
char *status; 
unsigned long buffer length; 
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CDA$_ENDOFDOC; 


get_prm->rab$w_rsz; 
get_prm->rab$l1_ rbf; 


CONVERT 


status = fgets(get_prm->fil buffer, get_prm->fil_buflen, 
get_prm->fs); 
if (status == NULL) 
i 
*num_ bytes = 0; 
return CDA$_ENDOFDOC; 
} 
buffer length = strlen(get_prm->fil_ buffer); 
if ((get_prm->fil_buffer) [buffer_length-1] == ’\n’) 
*num_bytes = buffer _length - 1; 
else 
*num_bytes = buffer_length; 
*buf_adr = get_pxrm->fil_buffer; 
return CDA$ NORMAL; 
#endif 
} 


main () 

{ 

unsigned long status; 

unsigned long text parameter; 

struct item_list standard_item_list{[{15]; 
unsigned long integer_value; 

unsigned long index; 

unsigned char text_filename[8]; 


printf ("Starting TEXT to DDIF procedure conversion\n"); 


#ifdef vms 
/* Open input text file */ 
text_fab = cc$rms_fab; 
text_rab = ccS$rms_rab; 
text _fab.fab$l1_fna = text_file; 
text_fab.fab$Sb_fns = text_file_ length; 
text_fab.fab$l_fop = FABSM _SQO; 
text _fab.fabSb rfm = FABSC_VAR; 
text. fab.fab$l_dna = text default; 
text fab.fab$b dns = text _default_length; 
text_rab.rab$l_ fab = &text_fab; 
text _rab.rab$l_rop = RABSM_LOC | RABSM_RAH; 
text_rab.rab$l_ ubf = text_ubf; 
text_rab.rab$w_usz = text_ubf_ size; 


status = sysSopen(é&text_ fab); 
if (FAILURE (status)) return status; 
status = sysSconnect (&text_rab); 
if (FAILURE (status) ) 
{ 
sys$close (&text_fab) ; 
return status; 


} 


#else 
strepy (text filename, text_file); 
strceat (text filename, text_default); 
text _filename[text file length + text_default_length] = 0; 
text_rab.fil buffer = text_ubf; 
text. rab.f11 puffer = text ubf; 
text_rab.fil_buflen = text_ubf_size; 
text _rab.fs = fopen(text_ filename, "r"); 
if (text_rab.fs == NULL) return CDA$_OPENFAIL; 
#endif 


/* Setup for conversion */ 
text_parameter = (unsigned long) é&text_rab; 


integer value = CDA$_START; 
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/* Input conversion parameters */ 

index = 0; 

standard_item_list [index] .cda$w_item_length = 
text_format_length; 

standard_item_list [index] .cda$w_item_code = 
CDA$_INPUT_FORMAT; 

standard_item_list [index] .cda$a_item_address = 
(char *) text_format; 

index += 1; 

standard_item_list [index] .cdaSw_item_length = 0; 

standard_item_list [index] .cda$w_item_code = 
CDA$_INPUT_ PROCEDURE; 

standard_item_list [index] .cda$a_item_address = (char *) 

input_text_procedure; 

index += 1; 

standard_item_list [index] .cda$w_item_length = 4; 

standard_item_list [index] .cda$w_item_code = 
CDAS_INPUT_PROCEDURE_PARM; 

standard_item_list [index] .cda$a_item_address = (char *) 

&text_ parameter; 
index += 1; 


/* Output conversion parameters */ 

standard_item_list [index] .cda$w_item_length = 
ddif_ format_length; 

standard item list [index] .cda$w_item_code = 
CDA$ OUTPUT FORMAT; 

standard_item_list [index] .cda$a_item_address = 
(char *) ddif_format; 

index += 1; 

standard_item list [index].cda$w_item_length = 
ddif file length; 

standard_item_list [index] .cda$w_item_code = 
CDAS_ OUTPUT FILE; 

standard_item_list [index] .cda$a_item_address = 
(char *) ddif_file; 

index += 1; 

standard _item_list [index] .cda$w_item_length = 
ddif_default_length; 

standard _item_list [index] .cda$w_item_code = 
CDA$ OUTPUT DEFAULT; 

standard _item_list [index] .cda$a_item_address = 
(char *) ddif_default; 

index += 1; 

standard_item_list [index] .cda$w_item_length 


standard_item_list [index] .cda$w_item_code = 0; 


/* Perform the conversion */ 
status = cda$convert (&integer value, standard_item_list, 0, 
&integer_ value) ; 
if (FAILURE (status) ) 
return (status); 


#ifdef vms 

/* Close the input file */ 

status = sys$close(&text_fab); 

if (FAILURE(status)) return status; 
#else 

fclose(text_rab.fs); 
#fendif 


printf ("Completed TEXT to DDIF procedure conversion\n") ; 
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To compile and run this program on VMS systems, you can use the following DCL 
commands: 


$cc 


_§$ /OPTIMIZE=NODISJOINT - 
_$ /NOLIST - 
_$ TEXT_CONVERTER.C 


$ LINK /EXE=TEXT_CONVERTER ~- 
_$ /NOMAP - 


_$ TEXT_CONVERTER, SYSSINPUT: /OPTION 
SYSSLIBRARY : CDASACCESS/ SHARE 
SYSSSHARE:VAXCRTL/SHARE ~ 


$ RUN TEXT CONVERTER 


To compile and run this program on ULTRIX systems, you can use the following 
commands: 


oe 


cc -o text_converter text_converter.c -lddif -lm 
text converter 


oe 
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CONVERT AGGREGATE 


the aggregate type 


Reads the next aggregate from a specified front end. 


VAX FORMAT 


status = cda$convert_aggregate 


Argument Information 


Argument 


status 


root-aggregate-handle 


front-end-handle 


aggregate-handle 


aggregate-type 
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(root-aggregate-handle ,front-end-hanale 
,aggregate-handle ,aggregate-type) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: © by reference 


C FORMAT 


CONVERT AGGREGATE 


status = CdaConvertAggregate 


(root_aggregate_handle, front_end_handle, 
aggregate_handle, aggregate_type) 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaConvertAggregate (root_aggregate_handle, 
front_end_ handle, aggregate handle, 
aggregate type) 


unsigned long root_aggregate handle; 
unsigned long front_end_handle; 
unsigned long xaggregate handle; 
unsigned long *aggregate type; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 
Identifier of the root aggregate associated with the aggregate to be read. This 
handle is returned by a call to the CREATE ROOT AGGREGATE routine. 


When reading aggregates using this routine, you must use the same value for 
root-aggregate-handle consistently to read all the aggregates in the compound 
document. Once you have read all the aggregates, you cannot specify the same 
root-aggregate-handle again when calling this routine. 


front-end-handle 

Identifier of the front end that reads the aggregate. This handle is either re- 
turned by a call to the OPEN CONVERTER routine, or is passed as a parameter 
to the ddif$write_format or dtif$write_format entry point in the back end. 


aggregate-handle 
Receives the handle of the aggregate just read. This handle must be used in all 
subsequent operations on that aggregate. 


aggregate-type 


Receives the aggregate type. If the aggregate type is DDIF$_EOS (end of 
segment), then the value of aggregate-handle is 0. 
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Description 


The aggregate type returned can be any one of the primary DDIF or DTIF 


aggregates: 


Aggregate Type 


DDIF$_DSC 
DDIF$_DHD 
DDIF$_SEG 
DDIF$_TXT 
DDIF$_GTX 
DDIF$_HRD 
DDIF$_SFT 
DDIF$_HRV 
DDIF$_SFV 
DDIF$_BEZ 
DDIF$_LIN 
DDIF$_ARC 
DDIF$_FAS 
DDIF$_IMG 
DDIF$_CRF 
DDIF$_EXT 
DDIF$_PVT 
DDIF$_GLY 
DDIF$_EOS 
DTIF$_DSC 
DTIF$_HDR 
DTIF$_TBL 
DTIF$_ROW 
DTIF$_CLD 


Note that the returned aggregate is not part of a sequence. 


The CONVERT AGGREGATE routine lets your application read the next 
aggregate from the specified front end. This routine can only be invoked by a — 


back end. 
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Meaning 
Document descriptor 
Document header 
Document segment 
Text content 
General text content 
Hard directive 

Soft directive 

Hard value directive 
Soft value directive 
Bézier curve content 
Polyline content 

Arc content 

Fill area set content 
Image content 
Content reference 
External content 
Private content 
Layout galley 

End of segment 
Document descriptor 
Document header 
Table definition 
Row definition 

Cell data 


RETURN VALUES 


Return Value 


CDA$_ENDOFDOC 
CDA$_INVAGGTYP 
CDA$_INVDOC 
CDA$_NORMAL 
CDA$_UNSUPCNV 


CONVERT AGGREGATE 


Description 


End of document 

Invalid aggregate type 
Invalid document content 
Normal successful completion 


Unsupported conversion 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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CONVERT DOCUMENT 


Reads an entire document from a specified front end. 


VAX FORMAT 


status = cda$convert_document 


Argument Information 


Argument 


status 


root-aggregate-handle 


front-end-handle 


C FORMAT 


(root-aggregate-handle ,front-end-handle) 


Argument Information — 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


status = CdaConvertDocument 
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(root_aggregate_handle, front_end_handle) 


CONVERT DOCUMENT 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaConvertDocument (root_aggregate_handle, 
front_end_handle) 
unsigned long root_aggregate_handle; 
unsigned long front_end_handle; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 
Identifier of the root aggregate associated with the document being read. This 
root aggregate handle is returned by a call to the CREATE ROOT AGGREGATE 


routine. 


Once you read an entire document, you cannot call the CONVERT DOCUMENT 
routine specifying the same root aggregate handle again. That is, you can only 
read a document associated with a particular root aggregate once. 


front-end-handle 

Identifier of the front end that reads the document. This handle is passed to 
the back end as a parameter to the ddif$write_format or dtif$write_format 
entry point in the back end. In addition, when a front end calls the OPEN 
CONVERTER routine, the new front end handle is returned. 


The CONVERT DOCUMENT routine lets your application read an entire 
document from the specified front end. This routine can only be invoked by a 
back end. On return from this routine, the entire document is present in memory 
in aggregates linked from the document root aggregate. 
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RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 
CDA$_INVDOC Invalid document content 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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CONVERT POSITION 


CONVERT POSITION 


Returns the current position in the input stream being processed, as well as the 
total size of the input stream. 


VAX FORMAT 
status = cda$convert_position 
(front-end-handle ,stream-position ,stream-size) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

front-end-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only | 
Mechanism: by reference 

stream-position VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

stream-size VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 


status = CdaConvertPosition 
(front_end_handle, stream_position, stream_size) 
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CONVERT POSITION 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaConvertPosition(front_end_handle, 
stream position, stream_size) 


unsigned long front_end_handle; 
unsigned long *stream_ position; 
unsigned long *stream_size; 


status 
A condition value indicating the return status of the routine call. 


front-end-handle 

Identifier of the front end that is processing the input stream. The front end 
handle is either returned by a call to the OPEN CONVERTER routine or is 
passed as a parameter to ddif$write_format or dtif$write_format. 


stream-position 
Receives the current position (in bytes or aggregates) as measured from the start 
of the input stream being processed. 


stream-size 
Receives the total size (in bytes or aggregates) of the input stream being pro- 
cessed. 


The CONVERT POSITION routine returns the current position in the input 
stream being processed, as well as the total size of a document being processed by 
the CONVERT AGGREGATE routine. The numbers are either in units of bytes 
or aggregates. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


Any condition value returned by the front end get-position procedure. 


8-32 CDA Toolkit Routines 


COPY AGGREGATE 


COPY AGGREGATE 


Creates a copy of an aggregate and its entire substructure. If the specified 
aggregate is part of a sequence, only the aggregate specified and its substructure, 


rather than the entire sequence, is copied. 


VAX FORMAT 


status = cda$copy_aggregate 


(root-aggregate-handle ,input-aggregate-handle 


,output-aggregate-handle) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
input-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
output-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
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COPY AGGREGATE 


C FORMAT 


status = CdaCopyAggregate 


(root_aggregate_handle, input_aggregate_handle, 
output_aggregate_handle) 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaCopyAggregate (root_aggregate_handle, 
input_aggregate handle, 
output_aggregate_handle) 


unsigned long root_aggregate_ handle; 
unsigned long input_aggregate_handle; 
unsigned long *xoutput_aggregate_handle; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate with which the copied aggregate is associated. 
The new copy of the aggregate becomes part of the document identified by this 
root aggregate handle. This root aggregate handle is returned by a call to either 
the OPEN FILE routine or the CREATE ROOT AGGREGATE routine. 


input-aggregate-handle 
Identifier of the aggregate to be copied. 


output-aggregate-handle 
Receives the handle of the new copy of the specified aggregate. This new 
aggregate handle must be used in all subsequent operations on that aggregate. 


The COPY AGGREGATE routine makes a copy of the specified aggregate and its 
entire substructure. This copy becomes part of the document identified by the 
specified root aggregate handle argument, and it is assigned a unique aggregate 
identifier, specified by the output aggregate handle argument. 


8-34 CDA Toolkit Routines 


COPY AGGREGATE 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 
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CREATE AGGREGATE 


Creates a new aggregate that contains empty items. Once this aggregate is 


created, it can be populated using the STORE ITEM routine. 


VAX FORMAT 


status = cda$create_aggregate 


Argument Information 


Argument 


status 


root-aggregate-handle 


aggregate-type 


aggregate-handle 
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(root-aggregate-handle ,aggregate-type 
,aggregate-handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 


CREATE AGGREGATE 


status = CdaCreateAggregate 


(root_aggregate_handle, aggregate_type, 
aggregate_handle) 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaCreateAggregate (root_aggregate_handle, 
aggregate type, aggregate_handle) 


unsigned long root_aggregate_ handle; 
unsigned long aggregate type; 
unsigned long *aggregate_handle; 


Status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate with which the newly created aggregate is 
associated. This handle is returned by a call to either the OPEN FILE routine or 
the CREATE ROOT AGGREGATE routine. 


aggregate-type 

The type of aggregate to be created, expressed as a symbolic constant. The 
aggregate type symbolic constants are defined in the files ddif$def.h and dtif$def.h 
on VMS systems and in the files ddif_def.h and dtif_def.h on ULTRIX systems. 


aggregate-handle 
Receives the identifier of the newly created aggregate. This handle must be used 
in all subsequent operations on that aggregate. 


The CREATE AGGREGATE routine creates a new aggregate of the specified type 
that contains empty items. Once this aggregate is created, it can be populated 
using the STORE ITEM routine. The created aggregate is part of the document 
specified by the root aggregate handle. 
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CREATE AGGREGATE 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 


Any error returned by the memory allocation routines. 
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CREATE FILE 


CREATE FILE 


Creates a new compound document file for output. An output stream is also 


created. 


VAX FORMAT 


status = cda$create_file 


Argument Information 


Argument 


status 


file-spec-len 


file-spec 


default-file-spec-len 


(file-spec-len ,file-spec ,default-file-spec-len 
,default-file-spec ,alloc-rtn ,dealloc-rtn 
,alloc-dealloc-prm ,root-aggregate-handle 
,result-file-spec-len ,result-file-spec 
,result-file-ret-len ,stream-handle , file-handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: char_string 

Data type: character string 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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CREATE FILE 


Argument 


default-file-spec 


alloc-rtn 


dealloc-rtn 


alloc-dealloc-prm 


root-aggregate-handle 


result-file-spec-len 


result-file-spec 


result-file-ret-len 
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Argument Information 

VMS usage: char_string 

Data type: character string 

Access: read only 

Mechanism: by reference 

VMS usage: procedure 

Data type: procedure entry mask 

Access: call after stack unwind 

Mechanism: by reference, procedure refer- 
ence 

VMS usage: procedure 

Data type: procedure entry mask 

Access: call after stack unwind 

Mechanism: by reference, procedure refer- 
ence 

VMS usage: context 

Data type: longword (unsigned) 

Access: read only 

Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 

Access: read only 

Mechanism: by reference 

VMS usage: longword_unsigned 

Data type: longword (unsigned) 

Access: read only 

Mechanism: by reference 

VMS usage: char_string 

Data type: character string 

Access: write only 

Mechanism: by reference 

VMS usage: longword_unsigned 

Data type: longword (unsigned) 

Access: write only 

Mechanism: by reference 


Argument 


stream-handle 


file-handle 


C FORMAT 


CREATE FILE 


Argument Information 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaCreateFile 


Argument Information 


(file_spec_len, file_spec, default_file_spec_len, 
default_file_spec, alloc_rtn, dealloc_rtn, 
alloc_dealloc_prm, root_aggregate_handle, 
result_file_spec_len, result_file_spec, 
result_file_ret_len, stream_handle, file_handle) 


unsigned long CdaCreateFile(file_spec_len, file spec, 


unsigned long 
unsigned char 
unsigned long 
unsigned char 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned char 
unsigned long 
unsigned long 
unsigned long 


default file spec_len, default_file spec, 
alloc_rtn, dealloc_rtn, alloc_dealloc_prm, 
root_aggregate_handle, result _file_spec len, 
result file spec, result _file_ret_len, 
stream handle, file handle) 

file spec len; 

*file spec; 
default_file_spec_len; 
*default_file spec; 
(*alloc_rtn) (); 
(*dealloc_rtn) (); 

alloc _dealloc_prm; 
root_aggregate_handle; 
result_file spec len; 
*result_file_spec; 
“result. file ret: ten; 
*stream_handle; 
*file.handie; 
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CREATE FILE 


RETURNS 


status 
A condition value indicating the return status of the routine call. 


Arguments 


file-spec-len 
The length (in bytes) of the string specified by the file-spec parameter. 


file-spec 
The file specification. 


default-file-spec-len 

The length (in bytes) of the buffer specified by default-file-spec. If you specify a 
value of 0 for both the default-file-spec-len and default-file-spec arguments, a 
default file specification of “.ddif” is used. 


default-file-spec 

The default file specification. In order to simplify the porting of applications, the 
character string should consist of only a file type in lowercase characters. If you 
specify an address of 0 for both the default-file-spec-len and default-file-spec 
arguments, a default file specification of “.ddif’ is used. On ULTRIX systems, the 
string is appended to the file specification, if the file specification does not already 
contain a period. 


alloc-rtn 

Address of a memory allocation routine. The calling sequence for an allocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory allocation routine is used. For a description, see 
Chapter 9. 


dealloc-rin 

Address of a memory deallocation routine. The calling sequence for a deallocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory deallocation routine is used. For a description, 
see Chapter9. 


alloc-dealloc-prm 

User context to be passed to the memory allocation and deallocation routines. 
If the system default memory allocation or deallocation routine is used, this 
parameter is ignored. For a description, see Chapter 9. 


root-aggregate-handle 

Identifier of the root aggregate associated with the newly created compound 
document. This handle must be used in all subsequent operations on that root 
aggregate. This handle is returned by a call to the CREATE ROOT AGGREGATE 
routine. 


The root-aggregate-handle argument is used to specify the file type of the 
newly created document using the aggregate type DDIF$_DDF for a DDIF file or 
DTIF$_DTF for a DTIF file. 


8-42 CDA Toolkit Routines 


Description 


CREATE FILE 


result-file-spec-len | 
Length (in bytes) of the buffer specified by result-file-spec. If you specify 0 for 
this parameter, the length of the resultant file specification is not returned. 


result-file-spec © 

Receives the resultant file specification. If you specify 0 for this parameter, the 
resultant file specification is not returned. This file specification is the result of a 
VMS RMS $CREATE operation. On ULTRIX systems, the file-spec argument is 
copied to this buffer. 


result-file-ret-len 

Receives the actual length (in bytes) of the resultant file specification. If you 
specify 0 for this parameter, the actual length of the resultant file specification is 
not returned. 


stream-handle 
Receives the handle of the newly created compound document stream. This 
handle must be used in all subsequent operations on that stream. 


file-handle 
Receives the handle of the newly created compound document file. This handle 
must be used in all subsequent operations on that file. 


The CREATE FILE routine creates a new compound document file for output and 
also creates an output stream. Note that you must have created a document root 
aggregate (by a call to the CREATE ROOT AGGREGATE routine) prior to calling 
this routine. The handle of this document root aggregate must be passed to the 
CREATE FILE routine, and must also be used in all subsequent operations on 
that root aggregate. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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CREATE FILE 


Example 


This example illustrates a typical call to the CREATE FILE routine. The length 
of the file specification is specified by the spec_length parameter, and the file 
specification is example.ddif. This call does not specify a default file specification 
length or a default file specification; this combination defaults to a default file 
specification of .ddif. The system memory allocation and deallocation routines are 
passed as a zero value, meaning that the default system memory routines are 
used. The root aggregate handle specifies the root aggregate of the document. 
This root aggregate must exist prior to a call to this routine. 


The result_length, result_buffer, and result_length arguments contain 
information about the actual resultant file specification of the created file. The 
stream_handle and file_handle arguments receive the identifiers of the newly 
created stream and file. 


/* set up file for DDIF file */ 

Spec. tength = 12} 

result_length = sizeof (result_buffer) ; 

status = cdaScreate file(&spec_length, "example.ddif", 0, 0, 
0, O, O, 
&root_aggregate_ handle, 
é&result_length, 
&result _buffer[0], &result_length, 
&stream_handle, &file handle); 

if (FAILURE (status)) return(status); 
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CREATE ROOT AGGREGATE 


CREATE ROOT AGGREGATE 


Creates a document root aggregate. 


VAX FORMAT 
status = cda$create_root_aggregate 


(alloc-rtn ,dealloc-rtn ,alloc-dealloc-prm 
,Processing-options ,aggregate-type 
,root-aggregate-handle) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
alloc-rtn VMS usage: procedure 
Data type: procedure entry mask | 
Access: call after stack unwind 
Mechanism: by reference, procedure refer- 
ence 
dealloc-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference, procedure refer- 
ence 
alloc-dealloc-prm VMS usage: context 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 
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Argument Argument Information 
processing-options VMS usage: item_list_2 
Data type: record 
Access: read only 
Mechanism: by reference, array reference 
aggregate-type VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 
status = CdaCreateRootAggregate 
(alloc_rtn, dealloc_rtn, alloc_dealloc_prm, 
processing_options, aggregate _type, 
root_aggregate_handle) 


Argument Information 


unsigned long CdaCreateRootAggregate(alloc_rtn, dealloc_rtn, 
alloc_dealloc_prm, processing options, 
aggregate type, root_aggregate_handle) 


unsigned long (*alloc_rtn) (); 
unsigned long (*dealloc_rtn) (); 
unsigned long *processing options; 
unsigned long alloc _dealloc_prm; 
unsigned long aggregate type; 
unsigned long *root_aggregate_handle; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 
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Arguments 


CREATE ROOT AGGREGATE 


alloc-rin 

Address of a memory allocation routine. The calling sequence for an allocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory allocation routine is used. For a description, see 
Chapter 9. 


dealloc-rtn 

Address of a memory deallocation routine. The calling sequence for a deallocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory deallocation routine is used. For a description, 
see Chapter 9. 


alloc-dealloc-prm 

User context to be passed to the memory allocation and deallocation routines. 
If the system default memory allocation or deallocation routine is used, this 
parameter is ignored. For a description, see Chapter 9. 


processing-options 

An item list containing options to control input processing. Each entry in the 
item list is a 2-longword structure. To terminate the item list you must specify 
the final entry or longword as 0. Valid item codes are as follows: 


DDIF$_INHERIT_ATTRIBUTES Attribute inheritance is applied to all docu- 
ment segments. First, if a segment has a type 
reference that corresponds to a type definition, 
the attributes of the type are applied to the 
segment. 


If a segment is the root segment, and a style 
guide is referenced in the document’s header, 
the definitions and layout from the style guide 
are applied to the root segment. For the root 
segment only, standard defined initial values 
are applied to the attributes of the segment 
that do not yet have values. 


If the segment is not the root segment, at- 
tribute values of its parent segment are 
applied to the attributes of the segment that 
do not yet have values. For more information 
on the inherit attributes processing option, see 
Section 1.6.1. 


DDIF$_RETAIN_DEFINITIONS Segment definitions that enable the operation 
of CDA$FIND_DEFINITION are retained. 
This item code is required only if neither 
DDIF$_INHERIT_ATTRIBUTES nor DDIF$_ 
EVALUATE_CONTENT is specified. For 
more information on the retain definitions 
processing option, see Section 1.6.2. 
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CREATE ROOT AGGREGATE 


DDIF$_EVALUATE_CONTENT 


DDIF$_DISCARD_I_SEGMENTS 


DDIF$_DISCARD_2D_SEGMENTS 


DDIF$_DISCARD_T_SEGMENTS 


DDIF$_DISCARD_TBL_SEGMENTS 


DDIF$_DISCARD_PDL_SEGMENTS 


Content reference (DDIF$_CRF) aggregates 
are replaced with the value of the definition 
(DDIF$_CTD) they reference. The value of 
this content definition may be in the current 
document or in an external document. 


Content for segments with the DDIF$_SGA_ 
COMPUTE_C item present in the segment’s 
attributes (DDIF$_SGA) may be imported 
from an external reference. If the value 

of the DDIF$_SGA_COMPUTE_C item is 
DDIF$K_REMOTE_COMPUTE, the external 
content is imported and replaces the segment’s 
original content. If the value of the DDIF$_ 
SGA_COMPUTE_C item is DDIF$_K_COPY_ 
COMPUTE, the external content is imported 
only if the segment has no content. For more 
information on the evaluate content processing 
option, see Section 1.6.3. 


Segments of the image ($1) content category, 
and any nested segments, are discarded. 

For more information on the discard image 
segments processing option, see Section 1.6.4. 


Segments of the graphics ($2D ) content cate- 
gory, and any nested segments, are discarded. 
For more information on the discard graphics 
segments processing option, see Section 1.6.4. 


Segments of the text ($T) content category, 
and any nested segments, are discarded. For 
more information on the discard text segments 
processing option, see Section 1.6.4. 


Segments of the table ($TBL) content cate- 
gory, and any nested segments, are discarded. 
For more information on the discard table 
segments processing option, see Section 1.6.4. 


Segments of the page description language 
($PDL) content category, and any nested seg- 
ments, are discarded. For more information 
on the discard page descriptions language 
segments processing option, see Section 1.6.4. 


This item list contains options only to control input processing. If you are 
creating a root aggregate for output processing, you must specify both an item 


length and an item buffer address of 0. 


aggregate-type 


The type of aggregate to be created, expressed as a symbolic constant. The only 
valid root aggregate types are DDIF$_DDF and DTIF$_DTF. 


root-aggregate-handle 


Receives a value that identifies the newly created root aggregate. This handle 
must be used in all subsequent operations on that root aggregate. 
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Description 


CREATE ROOT AGGREGATE 


The CREATE ROOT AGGREGATE routine creates a document root aggregate. 


RETURN VALUES 


Example 


Return Value 
CDA$_NORMAL 
CDA$_INVAGGTYP 
CDA$_INVITMLST 


Description 
Normal successful completion 
Invalid aggregate type 


Invalid item list 


Any error returned by the memory allocation routines. 


This code segment illustrates a typical call to the CREATE ROOT AGGREGATE 
routine. The first four parameters are passed as zero values, indicating that the 
default system memory allocation and deallocation routines are used and that no 
processing options are specified. The aggregate type passed is DDIF$_DDF, which 
is the document root aggregate, and the root aggregate handle that is returned is 
used to identify that document throughout the program. 


aggregate type = DDIF$ DDF; 


status = 


cdaScreate root_aggregate(0, 0, 0, 0, &aggregate_type, 
&root_aggregate_handle) ; 


if (FAILURE (status)) return(status); 
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CREATE STREAM 


Opens a compound document stream for output. 


VAX FORMAT 
status = cda$create_stream 


(alloc-rtn ,dealloc-rin ,alloc-dealloc-prm , put-rtn 
,put-prm ,buf-len ,buf-adr ,stream-handle) 


Argument Information 


Argument Argument Information 
status | VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
alloc-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference, procedure refer- 
ence 
dealloc-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference, procedure refer- 
ence 
alloc-dealloc-prm VMS usage: context 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 
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C FORMAT 


Argument 
put-rtn 


put-prm 


buf-len 


buf-adr 


stream-handle 


status = CdaCreateStream 


CREATE STREAM 


Argument Information 


VMS usage: 
Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 


Access: 


Mechanism: 


VMS usage: 
Data type: 
Access: 
Mechanism: 


VMS usage: 
Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 


Access: 


Mechanism: 


procedure 
procedure entry mask 
read only 


by reference, procedure refer- 
ence 
user_arg 


longword (unsigned) 
read only 


by value 


longword_unsigned 
longword (unsigned) 
read only 


by reference 


vector_byte_unsigned 
byte (unsigned) 
read only 


by reference, array reference 


identifier 
longword (unsigned) 
write only 


by reference 


(alloc_rtn, dealloc_rtn, alloc_dealloc_prm, put_rtn, 
put_prm, buf_len, buf_adr, stream_handle) 
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Argument Information 


RETURNS 


Arguments 


unsigned long CdaCreateStream(alloc rtn, dealloc_rtn, 
alloc_dealloc_prm, put_rtn, put_prm, 
buf_len, buf_adr, stream_handle) 


unsigned long (*alloc rtn) () 3 
unsigned long (*dealloc_rtn) (); 
unsigned long alloc _dealloc_prm; 
unsigned long (put ren) ()3 
unsigned long put_prm; 

unsigned long buf_len; 

unsigned char *buf_adr; 
unsigned long *stream_ handle; 


status 
A condition value indicating the return status of the routine call. 


alloc-rtn 

Address of a memory allocation routine. The calling sequence for an allocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory allocation routine is used. For a description, see 
Chapter 9. 


dealloc-rin 

Address of a memory deallocation routine. The calling sequence for a deallocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory deallocation routine is used. For a description, 
see Chapter 9. 


alloc-dealloc-prm 

User context to be passed to the memory allocation and deallocation routines. 
If the system default memory allocation or deallocation routine is used, this 
parameter is ignored. For a description, see Chapter 9. 


put-rtn 

Address of a stream put routine. The calling sequence for a put routine is defined 
in Chapter 9. If you specify 0 for this argument on VMS systems, a system 
default routine is used. On ULTRIX systems, you must provide both a put-rtn 
and put-prm; there is no default. If you specify a value other than the default for 
this argument, you must also specify a value for the put-prm argument. 
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Description 


CREATE STREAM 


put-prm 

User context to be passed to the stream put routine. If the VMS system default 
put routine is used, the value must be a pointer to a RAB. On ULTRIX sys- 
tems, you must provide both a put-rtn and put-prm; there is no default. For a 
description, see Chapter 9. 


buf-len 
Length of the buffer specified by the buf-adr parameter. 


buf-adr 
Address of a buffer ‘int receives the output data. 


stream-handle 
Receives the handle of the newly created stream. This handle must be used in all 
subsequent operations on that stream. 


The CREATE STREAM routine opens a compound document stream for output. 
The number of streams that you can open simultaneously is limited si by the 
amount of memory available. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


Any error returned by the memory allocation routines. 
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CREATE TEXT FILE 


Creates a standard text file for output. 


VAX FORMAT 


status = cda$create_text_file 
(file-spec-len ,file-spec ,default-file-spec-len 
,default-file-spec ,result-file-spec-len 
,result-file-spec ,result-file-ret-len ,text-file-handle) 


Argument Information 


Argument 


status 


file-spec-len 


file-spec 


default-file-spec-len 


default-file-spec 
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Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: char_string 

Data type: character string 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: char_string 

Data type: character string 
Access: read only 
Mechanism: by reference 


C FORMAT 


CREATE TEXT FILE 


Argument Argument Information 
result-file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
result-file-spec VMS usage: char_string 
Data type: character string 
Access: write only 
Mechanism: by reference 
result-file-ret-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
text-file-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaCreateTextFile 
(file_spec_len, file_spec, default_file_spec_len, 
default_file_spec, result_file_spec_len, 
result_file_spec, result_file_ret_len, 
text_file_handle) 
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CREATE TEXT FILE 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaCreateTextFile(file_spec_len, file_spec, 
default file _spec_len, default_file_ spec, 
result_file_spec_len, result_file_ spec, 
result file ret_len, text_file handle) 


unsigned long file spec len; 
unsigned char *file_ spec; 

unsigned long default _file spec_len; 
unsigned char *default_file spec; 
unsigned long result_file_spec_len; 
unsigned char *resule £2 le spec? 
unsigned long *result_file ret_len; 
unsigned long *text_file handle; 


Status 
A condition value indicating the return status of the routine call. 


file-spec-len 
Length (in bytes) of the string specified by the file-spec argument. 


file-spec 
File specification of the text file to be created for output. 


default-file-spec-len 
Length (in bytes) of the string specified by default-file-spec. If you specify 0 for 
this parameter, no default file specification is used. 


default-file-spec 

Default file specification. If you specify 0 for this parameter, no default file 
specification is used. The string should consist only of a file type in lowercase 
characters. On ULTRIX systems, the string is appended to the file specification if 
the file specification does not already contain a period. 


result-file-spec-len 
Length (in bytes) of the buffer specified by result-file-spec. If you specify 0 for 
this parameter, the length of the resultant file specification is not returned. 


result-file-spec . 

Receives the resultant file specification. This file specification is the result of a 
VMS RMS $CREATE operation. On ULTRIX systems, the file-spec is copied to 
this buffer. If you specify 0 for this parameter, a resultant file specification is not 
returned. . 
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CREATE TEXT FILE 


result-file-ret-len 

Receives the actual length (in bytes) of the resultant file specification. If you 
specify 0 for this parameter, the actual length of the resultant file specification is 
not returned. 


text-file-handle 
Receives the handle of the text file. This handle must be used in all subsequent 
operations on that text file. 


The CREATE TEXT FILE routine creates a standard text file for output. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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DELETE AGGREGATE 


Destroys an aggregate and all of its substructure. If the specified aggregate is 
part of a sequence, the aggregate is cut from the sequence before being destroyed. 


VAX FORMAT 
status = cda$delete_aggregate 
(root-aggregate-handle ,aggregate-handle) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
‘Mechanism: by reference 

aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

C FORMAT 


status = CdaDeleteAggregate 
(root_aggregate_handle, aggregate_handle) 


8-58 CDA Toolkit Routines 


DELETE AGGREGATE 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaDeleteAggregate(root_aggregate_handle, 
aggregate_handle) 
unsigned long root_aggregate_handle; 
unsigned long aggregate_handle; 


Status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the aggregate to be deleted. This 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. 


aggregate-handle 
Identifier of the aggregate to be destroyed. 


The DELETE AGGREGATE routine destroys an aggregate and all of its substruc- 
ture. If the specified aggregate is part of a sequence, the aggregate is cut from 
the sequence before being destroyed. Note that the specified aggregate handle 
and the handles of any subaggregates linked to the specified aggregate either 
directly or indirectly to children of the root aggregate are invalid after a call to 
this routine. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 


Any error returned by the memory deallocation routines. 


CDA Toolkit Routines 8-59 


DELETE ROOT AGGREGATE 


DELETE ROOT AGGREGATE 


Destroys a document root aggregate and all of its substructure. 


VAX FORMAT 
status = cda$delete_root_aggregate 
(root-aggregate-handle) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


C FORMAT 
status = CdaDeleteRootAggregate 


(root_aggregate_handle) 


Argument Information 


unsigned long CdaDeleteRootAggregate (root_aggregate_handle) 
unsigned long root_aggregate_handle; 
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RETURNS 


Arguments 


Description 


DELETE ROOT AGGREGATE 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 
Identifier of the root aggregate to be deleted. This handle is returned by a call to 
either the OPEN FILE routine or the CREATE ROOT AGGREGATE routine. 


The DELETE ROOT AGGREGATE routine destroys a document root aggregate 
and all of its associated substructure. The root aggregate and its substructure 
form a tree structure, so that when the root aggregate is deleted, any aggregates 
attached to that root aggregate are also deleted. The root-aggregate-handle as 
well as the handles of any aggregates that are linked to the root aggregate either 
directly or indirectly are invalid after a call to this routine. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


Any error returned by the memory deallocation routines. 
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ENTER SCOPE 


Opens a document scope for incremental writing. 


VAX FORMAT 
status = cda$enter_scope 
(root-aggregate-handle ,stream-handle ,scope-code 


[,aggregate-handle]) 
Argument Information 
Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
stream-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
scope-code VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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C FORMAT 


ENTER SCOPE 


status = CdaEnterScope 


(root_aggregate_handle, stream_handle, 
scope_code, aggregate_handle) 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaEnterScope (root_aggregate_handle, 
stream_handle, scope code 
aggregate_ handle) 


unsigned long root_aggregate_ handle; 
unsigned long stream_handle; 
unsigned long scope code; 

unsigned long aggregate _ handle; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the document content to be 
incrementally written. This handle is returned by a call to either the OPEN FILE 
routine or the CREATE ROOT AGGREGATE routine. 


stream-handle 

Identifier of the stream associated with the document to be written. This handle 
is returned by a call to either the CREATE FILE routine or the CREATE 
STREAM routine. | 


scope-code 
Symbolic constant identifying the scope to be opened. Valid values for the DDIF 
root aggregate are as follows: 


Code Meaning 
DDIF$K_DOCUMENT_SCOPE Document scope 
DDIF$K_CONTENT_SCOPE Content scope 
DDIF$K_SEGMENT_SCOPE Segment scope 


Valid values for the DTIF root aggregate are as follows: 
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ENTER SCOPE 


Code Meaning 
DTIF$K_DOCUMENT_SCOPE Document scope 
DTIF$K_TABLE_SCOPE Table scope 

DTIF$K_ROW_SCOPE Row scope 

DTIF$K_CELLS_SCOPE Cell scope (for all cells in a row) 
aggregate-handle 

Identifier of an aggregate of the appropriate type, if required by the scope code 
specified. 


The aggregate must be completely populated, except that its content sequence 
must be empty. The DDIF scoped sections that require that the aggregate- 
handle be specified are as follows: 


Scope Value of Aggregate-Handle 
DDIF$K_SEGMENT_SCOPE Aggregate-handle is the handle of an aggregate 
of type DDIF$_SEG. 


The DTIF scoped sections that require that the aggregate-handle be specified 
are as follows: 


Scope Value of Aggregate-Handle 


DTIF$K_TABLE_SCOPE Aggregate-handle is the handle of the table 
aggregate, which contains everything to be specified 
except the rows. 


DTIF$K_ROW_SCOPE Aggregate-handle is the handle of the row ag- 
gregate, which contains everything to be specified 
except the cells. 


Description 


The ENTER SCOPE routine lets you open a particular document scope for 
incremental writing. The types of scopes that you can open for a DDIF-encoded 
document are the following: 


¢ DDIF$K_DOCUMENT_SCOPE 
¢ DDIF$K_CONTENT_SCOPE 
¢ DDIF$K_SEGMENT_SCOPE 


For a DTIF-encoded document, the types of scopes that you can open are as 
follows: 


¢ DTIF$K_DOCUMENT_SCOPE 
¢ DTIF$K_TABLE_SCOPE 

¢ DTIF$K_ROW_SCOPE 

e DTIF$K_CELLS_SCOPE 
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ENTER SCOPE 


Using Scope to Write DDIF Documents Incrementally 


When performing incremental writing on a DDIF-encoded document, you should 
perform the following steps: 


1. 


Call the ENTER SCOPE routine, specifying scope-code as DDIF$K_ 
DOCUMENT_SCOPE. 


Write an aggregate of type DDIF$_DSC. 
Write an aggregate of type DDIF$_DHD. 


Call the ENTER SCOPE routine, specifying scope-code as DDIF$K_ 
CONTENT_SCOPE. 


Write a root segment of type DDIF$_SEG. The root segment is a top-level 
segment that contains the document content. This document content can 
consist of content aggregates as well as nested segments. If the document 
contains only one segment, that segment is the root segment and it contains 
all of the document content. If the document contains multiple segments, 
they must be nested within a root segment. 


You can use either of the following methods to create the root segment. 
Because the first method requires that the entire segment be completed 
before calling the PUT AGGREGATE routine, once you select that method 
you must continue to use that method while writing all of the document 
content. If you select the second method, you can use either method to write 
any nested segments. Again, if while writing nested segments, you select the 
first method, you must continue to use that method, and so on. 


a. Call the PUT AGGREGATE routine with a completed aggregate of type 


DDIF$_SEG, whose DDIF$_SEG_CONTENT item references a sequence 
of aggregates that make up the entire content for that segment, including 
any nested segments. Using this method, you need only call the PUT 
AGGREGATE routine once, because the DDIF$_SEG aggregate written in 
the call to PUT AGGREGATE is already completely populated. 


b. Call the ENTER SCOPE routine, specifying scope-code as DDIF$K_ 
SEGMENT_SCOPE, with a completed aggregate of type DDIF$_SEG 
whose DDIF$_SEG_CONTENT item is empty. You can then call the PUT 
AGGREGATE routine for each aggregate that makes up the segment 
content, in order. Once that segment and all its nested segments have 
been output, call the LEAVE SCOPE routine, specifying scope-code as 
DDIF$K_SEGMENT_SCOPE to complete that segment. 


Call the LEAVE SCOPE routine, specifying scope-code as DDIF$K_ 
CONTENT_SCOPE. 


Call the LEAVE SCOPE routine, specifying scope-code as DDIF$K_ 
DOCUMENT_SCOPE. 


When you call the ENTER SCOPE routine with scope-code specified as 
DDIF$K_SEGMENT_SCOPE, you can write aggregates of the following types 
within the segment, provided that the appropriate restrictions on content types 
within content categories are observed: 
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Aggregate Type Meaning 
DDIF$_SEG Document segment 
DDIF$_TXT Text content 
DDIF$_HRD Hard directive 
DDIF$_SFT Soft directive 
DDIF$_LIN Polyline content 
DDIF$_ARC Are content 
DDIF$_BEZ Bézier curve content 
DDIF$_IMG Image content 
DDIF$_CRF Content reference 
DDIF$_EXT External content 
DDIF$_PVT Private content 


Using Scope to Write DTIF Documents Incrementally 


When performing incremental writing of a DTIF-encoded document, you should 
perform the following steps: 


1. Call the ENTER SCOPE routine, specifying scope-code as DTIF$K_ 
DOCUMENT_SCOPE. 


2. Create a header (type DTIF$_HDR) aggregate and write it using the PUT 
AGGREGATE routine. 


3. Create a table (DTIF$_TBL) aggregate, specifying everything to be written 
except the table rows. 


4, Call the ENTER SCOPE routine, specifying scope-code as DTIF$K_TABLE_ 
SCOPE and aggregate-handle as the handle of the table aggregate to be 
written. 


5. Create a row (DTIF$_ROW) aggregate, specifying everything to be written 
except the row cells. 


6. Call the ENTER SCOPE routine, specifying scope-code as DTIF$K_ROW_ 
SCOPE and aggregate-handle as the handle of the row aggregate to be 
written. 


7. Call the ENTER SCOPE routine, specifying seope-code as DTIF$K_CELLS_ 
SCOPE (do not specify the aggregate-handle argument). 


8. Create and populate a cell (DTIF$_CLD) aggregate, and invoke the PUT 
AGGREGATE routine to write the completed aggregate. 


9. Repeat until all of the cells in the row have been written. 


10. Call the LEAVE SCOPE routine, specifying scope-code as DTIF$K_CELLS_ 
SCOPE. 


11. Call the LEAVE SCOPE routine, specifying scope-code as DTIF$K_ROW_ 
SCOPE. 


12. Repeat steps 6 through 11 for each row in the table. 


13. Once all the rows in the table have been completed, call the LEAVE SCOPE 
routine, specifying scope-code as DTIF$K_TABLE_SCOPE. 
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14. If there are additional tables to be created, repeat steps 4 through 13 to create 
the additional tables. 


15. Once all the tables in the document have been created, call the LEAVE 
SCOPE routine, specifying scope-code as DTIF$K_DOCUMENT_SCOPE. 


NOTE 


After calling the ENTER SCOPE routine, if your application no longer 
requires the aggregates written, you should issue a subsequent call to 
the DELETE AGGREGATE routine to destroy these aggregates. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVSCOCOD Invalid scope code 


Any errors returned by the file routines. 


Examples 


The following example shows how to incrementally read a DDIF document and 
write it to another DDIF file using the PUT AGGREGATE, ENTER SCOPE, and 
LEAVE SCOPE routines. 


/* Get the document from the front end using the aggregate method */ 
while (SUCCESS(status = cdaSconvert_aggregate (&root_aggregate handle, 
fre_ handle, 
é&aggregate_ handle, 
&aggregate type) )) 


switch (aggregate type) 
{ 

/* If the aggregate type is DDIF$ DSC, the document 
descriptor aggregate, then enter document scope 
and write the aggregate to the stream */ 

case DDIFS$ DSC: 

/* The first aggregate is incrementally read--enter 
the document scope here before putting out the 
aggregate */ 

scope = DDIFS$K_DOCUMENT_ SCOPE; 
status = cdaSenter_ scope (&root_aggregate_handle, 
&stream handle, 
&scope); 
if (!SUCCESS (status) ) 
CLEANUP (status); 
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status = cdaSput_aggregate (&root_aggregate_ handle, 
&stream_handle, 
&aggregate handle); 
if (!SUCCESS (status) ) 
CLEANUP (status); 
break; 


Examples 


/* If the aggregate type is DDIFS$ DHD, the document 
header aggregate, then simply write the aggregate 
to the stream, since we’re already in the document 
scope */ 
case DDIFS$_DHD: 
status = cda$put_aggregate (&root_aggregate_ handle, 
&stream_handle, 
é&aggregate handle); 
if (!SUCCESS (status) ) 
CLEANUP (status); 


scope = DDIF$K_CONTENT_SCOPE; 
/* DDIFS$ DHD immediately precedes content--enter 

content scope here */ 

status = cdaSenter_scope (&root_aggregate_handle, 
&stream_ handle, 
&scope) ; 

if (!SUCCESS (status) ) 

CLEANUP (status); 
break; 


/* If the aggregate type is DDIF$ SEG, the segment 
aggregate, then enter the segment scope and write 
the aggregate to the stream */ 

case DDIF$ SEG: 

scope = DDIFSK_SEGMENT SCOPE; 

/* Enter segment scope passing segment handle-- 
this call outputs the segment aggregate--enter 
scope does put aggregate for segments */ 

status = cdaSenter scope (&root_aggregate_handle, 
&stream_handle, 
&scope, 
&aggregate handle) ; 
if (!SUCCESS (status) ) 
CLEANUP (status); 
break; 


/* If the aggregate type is DDIFS$ EOS, end of 
segment aggregate, then leave the segment scope */ 
case DDIF$_EOS: 

scope = DDIF$K_SEGMENT_ SCOPE; 

status = cda$leave_scope (&root_aggregate_handle, 
&stream_handle, 
&SCOPe) ; 

if (!SUCCESS (status) ) 

CLEANUP (status) ; 
break; 
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/* For any other aggregate type, simply write the 
aggregate to the stream */ 
default: 
status = cdaSput_aggregate (&root_aggregate_ handle, 
&stream_handle, 
&aggregate_handle); 
if (!SUCCESS (status) ) 
CLEANUP (status); 
break; 


/* Delete the aggregate(s) just processed */ 
status = cda$delete_aggregate (&root_aggregate_handle, 
&aggregate handle); 
if (!SUCCESS (status) ) . 
CLEANUP (status); 


/* Once all aggregates are processed, leave the content scope 
and the document scope */ 


The following example shows the incremental method of creating a document, 
using both methods outlined for writing nested segments. 


/* 


This is an example of using the incremental method to create a 
document with nested segments being output using different options. 


* / 

#ifdef vms 

#include <cda$def.h> 
#include <ddifSdef.h> 
#felse 

#include <cda_def.h> 
#include <ddif_def.h> 
#fendif 


#define FAILURE (x) (((x) & 1) == 0) 


main () 

{ 

unsigned long status; 

unsigned long aggregate type; 
unsigned long aggregate handle; 
unsigned long prev_aggregate_handle; 
unsigned long aggregate_item; 
unsigned long aggregate index; 
unsigned long add_info; 
unsigned long spec_length; 
unsigned long result_length; 
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unsigned char result _buffer[255]; 
unsigned long stream_handle; 
unsigned long file handle; 

unsigned long root_aggregate_handle; 
unsigned long segment_handle; 
unsigned long integer value; 
unsigned char byte value; 

unsigned long buffer length; 
unsigned long scope code; 


/* Create the root aggregate */ 

aggregate type = DDIFS$_DDF; 

status = cda$create_root_aggregate(0, 0, 0, 0, &aggregate type, 
&root_aggregate handle); 

if (FAILURE (status)) return(status); 


/* Create the file */ 

spec_length = 9; 

result_length = sizeof (result buffer); 

status = cdaScreate_file(&spec_ length, "test.ddif", 0, 0, 
O02 07 
é&root_aggregate_ handle, &result_length, 
éresult_buffer[0], &result_length, 

. &stream_ handle, &file_ handle) ; 
if (FAILURE (status)) return(status); 


/* Enter Document Scope */ 

scope code = DDIFSK_ DOCUMENT SCOPE; 

status = cda$enter_ scope (&root_aggregate_ handle, &stream_handle, 
&scope code); 

if (FAILURE (status)) return(status); 


/* Create, populate, put, and delete the descriptor aggregate */ 
aggregate type = DDIF$ DSC; 
status = cda$create_ aggregate (&root_aggregate_handle, 

&aggregate type, &aggregate_ handle) ; 
if (FAILURE (status)) return(status) ; 


aggregate item = DDIF$ DSC_MAJOR_VERSION; 

buffer length = sizeof (integer value) ; 

integer value = 1; 

status = cda$store_item(&root_aggregate handle, s&aggregate_handle, 
&aggregate item, &buffer_ length, é&integer value); 

if (FAILURE (status)) return(status); 


aggregate _item = DDIFS$ DSC_MINOR_VERSION; 

buffer length = sizeof (integer value); 

integer_value = 0; 

status = cda$store_item(&root_aggregate handle, &aggregate_handle, 
&aggregate_item, é&buffer_length, &integer_value); 

if (FAILURE (status)) return(status) ; 


aggregate_item = DDIF$ DSC_PRODUCT_ IDENTIFIER; 

buffer length = 4; 

status = cda$store item(&root_aggregate handle, s&aggregate_handle, 
&aggregate_item, &buffer length, "Test"); 

if (FAILURE (status)) return(status) ; 
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aggregate_item = DDIFS$ _DSC_PRODUCT_NAME; 

buffer length = 19; 

add_info = CDAS$K_ISO_LATINI1; 

aggregate index = 0; 

status = cda$store_item(&root_aggregate handle, &aggregate_handle, 
s&aggregate item, &buffer length, 
"Example Application", é&aggregate_ index, 
&add_info); 

if (FAILURE (status)) return(status) ; 


status = cda$put_aggregate (&root_aggregate_handle, 
&stream_ handle, &aggregate_ handle) ; 
if (FAILURE(status)) return(status); 


status = cdaSdelete_aggregate(&root_aggregate_handle, 
&aggregate handle); 
if (FAILURE (status)) return(status); 


/* Create, populate, put, and delete the header aggregate. */ 
aggregate type = DDIF$ DHD; 
status = cdaScreate_aggregate (&root_aggregate_handle, 

&aggregate type, saggregate handle); 
if (FAILURE(status)) return(status) ; 
prev_aggregate handle = aggregate_handle; 


/* Store header items here */ 


status = cdaSput_aggregate (&root_aggregate_handle, &stream_handle, 
&aggregate handle); 
if (FAILURE(status)) return(status) ; 


status = cda$delete aggregate (&root_aggregate_handle, 
&aggregate_ handle); 
if (FAILURE(status)) return(status) ; 


/* Enter Content Scope */ 

scope _code = DDIFSK_CONTENT_ SCOPE; 

status = cdaSenter scope (&root. aggregate handle, &stream_handle, 
&scope_ code) ; 

if (FAILURE(status)) return(status) ; 


/* Create the "root segment" aggregate, and fill it in except for 
the content. This will be output using cda$enter_scope, and 
its contents will be output incrementally. 

a 
aggregate type = DDIFS$_SEG; 
status = cdaScreate_aggregate (&root_aggregate_handle, 

&aggregate type, &aggregate_ handle); 
if (FAILURE (status)) return(status) ; 
segment_handle = aggregate_handle; 


/* Fill in any items needed at the top level. */ 
aggregate _type = DDIFS$_SGA; 
status = cda$create_aggregate(&root_aggregate_handle, 
&aggregate type, &aggregate handle); 
if (FAILURE (status)) return(status); 
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aggregate item = DDIF$ SEG SPECIFIC ATTRIBUTES; 

buffer length = sizeof (aggregate_handle) ; 

status = cda$store _item(&root_aggregate handle, &segment_handle, 
&aggregate item, &buffer length, 
éaggregate handle); 

if (FAILURE (status)) return(status) ; 


aggregate item = DDIF$ SGA_CONTENT_CATEGORY; 

add_info = DDIFS$K_T CATEGORY; 

status = cda$store_item(&root_aggregate handle, s&aggregate_handle, 
&aggregate item, 0, 0, 0, &add_info); 

if (FAILURE (status)) return(status) ; 


/* Enter Segment Scope. This requires the segment aggregate handle, 
and causes the segment aggregate to be output. */ 
scope code = DDIFS$K_SEGMENT SCOPE; 
status = cda$enter_scope(éroot_aggregate_ handle, &stream_handle, 
&scope code, &segment_handle); 
if (FAILURE (status)) return(status) ; 


/* Delete the segment aggregate */ 

status = cdaSdelete aggregate (&root_aggregate_ handle, 
&segment_handle) ; 

if (FAILURE(status)) return(status); 


/* Incrementally, create the content aggregates and put them out. */ 
aggregate type = DDIFS$ TXT; 
status = cdaScreate_ aggregate (&root_aggregate_ handle, 

é&aggregate type, &aggregate_handle); 
if (FAILURE (status)) return(status); 


aggregate item = DDIF$ TXT CONTENT; 

buffer length = 5; 

status = cda$store item(&root_aggregate handle, s&aggregate_handle, 
éaggregate item, &buffer_length, "Hello"); 

if (FAILURE(status)) return(status) ; 


status = cda$put_aggregate(&root_aggregate handle, &stream_handle, 
éaggregate_ handle); 
if (FAILURE(status)) return(status); 


/* Delete the text aggregate */ 

status = cda$delete_ aggregate (&root_aggregate_handle, 
éaggregate handle); 

if (FAILURE (status)) return(status) ; 


/* The next content element is a segment 
* Create a sement aggregate, link all its content to it, 
* and output the aggregate. (This segment does not use 
cdaSenter_ scope.) 
*/ 
aggregate type = DDIFS$_SEG; 
status = cda$create_aggregate (&root_aggregate handle, 
éaggregate type, é&aggregate handle); 
if (FAILURE (status)) return(status); 
segment_handle = aggregate_handle; 
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aggregate type = DDIFS SGA; 

status = cda$create_aggregate (&root_aggregate_handle, 
&aggregate type, é&aggregate_handle) ; 

if (FAILURE (status)) return(status) ; 


aggregate _ item = DDIFS SEG SPECIFIC _ATTRIBUTES; 

buffer length = sizeof (aggregate_handle) ; 

status = cda$store_item(&root_aggregate handle, &segment_handle, 
&aggregate item, &buffer length, 
&aggregate handle); 

if (FAILURE (status)) return(status); 


aggregate item = DDIF$ SGA CONTENT CATEGORY; 

add_info = DDIFS$K_T_CATEGORY; 

status = cda$store_item(&root_aggregate_ handle, &aggregate_handle, 
&aggregate_ item, 0, 0, 0, é&add_info); 

if (FAILURE (status)) return(status) ; 


/* Create content aggregates, and link them to 

* the segment aggregate. 

Nef 
aggregate type = DDIF$ TXT; 
status = cdaScreate_ aggregate (é&root_aggregate handle, 

&aggregate type, saggregate_ handle); 

if (FAILURE(status)) return(status) ; 
prev_aggregate_ handle = aggregate handle; 


aggregate _item = DDIFS$ SEG CONTENT; 

buffer length = sizeof (aggregate handle); 

status = cda$store _item(&root_aggregate_handle, &segment_handle, 
&aggregate item, &buffer_ length, 
&aggregate_ handle); 

if (FAILURE (status)) return(status) ; 


aggregate_item = DDIF$_TXT_CONTENT; 

buffer length = 5; 

status = cda$store item(&root_aggregate handle, éaggregate_ handle, 
&aggregate_item, &buffer_length, 
"There") ; 

if (FAILURE (status)) return(status); 


aggregate_type = DDIF$ HRD; 
status = cda$create_aggregate (&root_aggregate handle, 

é&aggregate type, &aggregate_ handle); 
if (FAILURE (status)) return(status); 


cdaSinsert_aggregate (&aggregate_handle, &prev_aggregate_handle) ; 


aggregate _item = DDIFS$ HRD_DIRECTIVE; 

buffer length = sizeof (integer _value); 

integer value = DDIFS$K_DIR_NEW_ PAGE; 

status = cda$store_item(&root_aggregate_handle, é&aggregate_handle, 
&aggregate item, &buffer_length, 
&integer value); 

if (FAILURE(status)) return(status); 
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/* Output the segment aggregate (Since the content is attached, 

* it is output also.) 

a7 

status = cdaSput_aggregate(&root_aggregate_handle, &stream_handle, 
&segment handle); 

if (FAILURE(status)) return(status) ; 


/* Delete the segment aggregate and all aggregates 

* attached to it. 

“nd 

status = cda$delete_aggregate (&root_aggregate_handle, 
&segment_handle); 

if (FAILURE (status)) return(status); 


/* Output more content aggregates within the root segment */ 


/* Leave Segment Scope. This is for the segment that was output 
using cda$enter_ scope. */ 
scope code = DDIF$K_SEGMENT SCOPE; 
status = cda$leave_scope (&root_aggregate_handle, &stream_handle, 
&scope code); 
if (FAILURE(status)) return(status) ; 


/* Leave Content Scope */ 

scope code = DDIFSK_CONTENT SCOPE; 

status = cdaSleave_scope(&root_aggregate_handle, &stream_handle, 
&scope_ code); 

if (FAILURE (status)) return(status); 


/* Leave Document Scope */ 

scope code = DDIF$K_DOCUMENT_SCOPE; 

status = cdaS$leave_scope(&root_aggregate_handle, &stream_handle, 
&scope code); 

if (FAILURE (status)) return(status) ; 


/* Close the file */ 
status = cda$close file(&stream_handle, &file_handle) ; 
if (FAILURE (status)) return(status); 


/* Delete the root aggregate */ 
status = cda$delete_ root_aggregate(&root_aggregate_handle); 
1£ (FAILURE (status)) return(status); 


return 1; 


} 


This example illustrates the use of both methods of incremental writing: using 
the PUT AGGREGATE routine with a completed segment or using ENTER 
SCOPE and incrementally writing the segment’s content. This program creates a 
DDIF file whose analysis would appear as follows: 
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DDIF_DOCUMENT 

{ 
DDF_DESCRIPTOR 
{ 


DSC_MAJOR_VERSION 1 ! Longword Integer 
DSC_MINOR_VERSION 0 ! Longword Integer 
DSC_PRODUCT_IDENTIFIER "%H54657374" ! Byte string = "Test" 


_DSC_PRODUCT_NAME 
( 
ISO_LATIN1 “Example Application" 
) 
} 
DDF_ HEADER 
{ 
} 
DDF_CONTENT 
{ 
SEG SPECIFIC ATTRIBUTES 
{ 
SGA_CONTENT CATEGORY T_ CATEGORY eo 
} 
SEG _ CONTENT 
it 
TXT CONTENT "SH48656C6C6F" ! Byte string = "Hello" 
} 
{ 
SEG SPECIFIC ATTRIBUTES 
{ 
SGA_CONTENT CATEGORY T_ CATEGORY "ST" 
} 
SEG_CONTENT 
{ 
TXT CONTENT "%$H5468657265" ! Byte string = "There" 
} 
{ 
HRD DIRECTIVE DIR_NEW_ PAGE ! Integer = 1 
} 
} 
} 
} 
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ERASE ITEM 


Erases (sets to empty) the contents of an item within an aggregate. If you erase 
an item that is indexed, the index of each subsequent item (each item with a 
higher index) decreases by 1. 


VAX FORMAT 
status = cda$erase_item 


(root-aggregate-handle ,aggregate-handle 
,aggregate-item [,aggregate-index]) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-item VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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ERASE ITEM 


Argument Argument Information 

aggregate-index VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


status = CdaEraseltem 


(root_aggregate_handle, aggregate_handle, 
aggregate_item, aggregate_index) 


Argument Information 


unsigned long CdaEraseItem(root_aggregate_handle, 
aggregate handle, aggregate_item, 
aggregate_index) 


unsigned long root_aggregate_handle; 
unsigned long aggregate_handle; 
unsigned long aggregate _ item; 
unsigned long aggregate_ index; 





RETURNS 


Arguments 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate of which the aggregate containing the item is a 
part. This handle is returned by a call to either the OPEN FILE routine or the 
CREATE ROOT AGGREGATE routine. 


aggregate-handle 
Identifier of the aggregate containing the item to be erased. 


aggregate-item 

Identifying code of the item to be erased, expressed as a symbolic constant. The 
DDIF aggregate item symbolic constants are defined in the file ddif$def.h on 
VMS systems and in the file ddif_def.h on ULTRIX systems and are discussed 
in Chapter 4. The DTIF aggregate item symbolic codes are defined in the file 
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dtif$def.h on VMS systems and in the file dtif_def.h on ULTRIX systems and are 
described in Chapter 5. 


aggregate-index 

Index of the item to be erased (relative to 0). This argument is required whenever 
the notation “Array of’ appears in the data type of the specified item handle. 
Otherwise, this argument is ignored and may be omitted. If an address of 0 is 
specified, all array elements in the item are erased. 


Description 


The ERASE ITEM routine erases (sets to empty) the contents of an item within 
an aggregate. If you erase an item that is indexed, the index of each subsequent 
item (each item with a higher index) decreases by 1. If you specify 0, all array 
elements in the item are erased. 


Note that if you erase an item that contains the handle of a subaggregate, the 
subagegregate is deleted. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion. 
CDA$_INVAGGTYP Invalid aggregate type. 
CDA$_INVITMCOD Invalid item code. 
CDA$_EMPTY Item is empty. 

CDA$_INDEX Index exceeds array bounds. 
CDA$_VAREMPTY Variant item is empty. . 
CDA$_VARINDEX Variant index exceeds bounds. 
CDA$_VARVALUE Variant value is undefined. 
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FIND DEFINITION 


Looks up the specified definition in a list of definitions. 


VAX FORMAT 
status = cda$find_definition 


(root-aggregate-handle ,aggregate-type ,buf-len 
,ouf-adr ,aggregate-handle) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

aggregate-type VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

buf-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

buf-adr VMS usage: vector_byte_unsigned 
Data type: byte (unsigned) 
Access: read only 
Mechanism: by reference, array reference 
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C FORMAT 


Argument Argument Information 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaFindDefinition 


(root_aggregate_handle, aggregate_type, buf_len, 
buf_adr, aggregate_handle) 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaFindDefinition(root_aggregate_handle, 
aggregate type, buf_len, buf_adr, 
aggregate_handle) 


unsigned long root_aggregate_handle; 
unsigned long aggregate type; 
unsigned long buf_len; 

unsigned char *buf_adr; 

unsigned long *aggregate_ handle; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate with which the definition aggregate being searched 
for is associated. This handle is returned by a call to either the OPEN FILE 
routine or the CREATE ROOT AGGREGATE routine. 


aggregate-type 

The type of definition aggregate being searched for, expressed as a symbolic 
constant. The DDIF aggregate type symbolic constants are defined in the file 
ddif$def.h on VMS systems and in the file ddif_def.h on ULTRIX systems and are 
discussed in Chapter 4. The DTIF aggregate type symbolic codes are defined in 
the file dtif$def.h on VMS systems and in the file dtif_def.h on ULTRIX systems 
and are described in Chapter 5. 
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buf-len 
Length of the buffer (in bytes) specified by buf-adr. 


buf-adr 

The buffer that contains the selector value used to indicate the desired defini- 
tion from the list of definitions. The definition aggregate types DDIF$_FTD, 
DDIF$_LSD, DDIF$_PHD, DDIF$_ERF, and DDIF$_PTD are identified in a 
series of definitions by a unique number. Therefore, for these aggregate types, 
the buf-adr value must be a longword. For aggregate types DDIF$_CTD, 
DDIF$_TYD, and DDIF$_SGB, which are assigned string labels, the value must 
be a string. 


aggregate-handle 
Receives a value that identifies the newly located definition aggregate. This 
handle must be used in all subsequent operations on that aggregate. 


The FIND DEFINITION routine looks up the specified definition in a se- 

ries of definition aggregates. For example, if you have several font definition 
(DDIF$_FTD) aggregates and you want to retrieve the definition of the font iden- 
tified by the index 3, you would invoke this routine, specifying the aggregate- 
type as DDIF$_FTD and the selector value (buf-adr) as 3. The aggregate types 
that can be specified for this routine are as follows: 


DDIF$_CTD Content definition aggregate 
DDIF$_ERF External reference aggregate 
DDIF$_FTD Font definition aggregate 
DDIF$_LSD Line style definition aggregate 
DDIF$_PHD Path definition aggregate 
DDIF$_PTD Pattern definition aggregate 
DDIF$_SGB Segment bindings aggregate 
DDIF$_TYD Type definition aggregate 


In order for this routine to return the correct information, you must have specified 
one or more of the following processing options in the call to the CREATE ROOT 
AGGREGATE routine: 


¢ DDIF$ INHERIT_ATTRIBUTES 
¢ DDIF$ EVALUATE_CONTENT 
¢ DDIF$_RETAIN_DEFINITIONS 


This routine is only valid when you are using the aggregate (incremental) method 
of document conversion, because the definition being determined is dependent 
upon the current location in the document. If you call this routine when you are 
performing document method conversion, the current position is the top of the 
document, so that no definition is available. 
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RETURN VALUES 


8-82 


Return Value 
CDA$_NORMAL 
CDA$_INVAGGTYP 
CDA$_INVBUFLEN 
CDA$_DEFNOTFOU 
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Description 

Normal successful completion 
Invalid aggregate type 
Invalid buffer length 


Definition not found 


FIND TRANSFORMATION 


FIND TRANSFORMATION 


Returns the current transformation matrix values. 


VAX FORMAT 
status = cda$find_transformation 


Argument Information 


C FORMAT 


Argument 


status 


root-aggregate-handle 


transformation 


(root-aggregate-handle ,transformation) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: address 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaFindTransformation 


(root_aggregate_handle, transformation) 


CDA Toolkit Routines 8-83 


FIND TRANSFORMATION 


Argument Information 


unsigned long CdaFindTransformation(root_aggregate_handle, 


transformation) 
unsigned long root_aggregate_ handle; 
float © *xtransformation; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 


Arguments 


root-aggregate-handle 
Identifier of the root aggregate. This handle is returned by a call to either the 
OPEN FILE routine or the CREATE ROOT AGGREGATE routine. 


transformation 
Receives the address of a vector of nine single-precision floating-point elements. 


The elements of this vector specify the current content transformation in column 
order. For example, the elements of the following array would be returned in the 
order A, B, C, D, E, F, G, H, I. 


A D G 
B E H 
Cc F I 


Description 


The FIND TRANSFORMATION routine returns the current values of the 
transformation matrix specified by the DDIF$_TRN aggregate. In order for this 
routine to return the correct information, you must have specified one or more of 


the following processing options in the call to the CREATE ROOT AGGREGATE 
routine: 


¢ DDIF$ _INHERIT_ATTRIBUTES 
¢ DDIF$EVALUATE_CONTENT 
e DDIF$_RETAIN_DEFINITIONS 
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RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 
CDA$_DEFNOTFOU Definition not found 
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FLUSH STREAM 


Flushes the contents of the stream and ensures that the data has been physically 
transferred to the receiving medium. 


VAX FORMAT 


status = cda$flush_stream 


Argument Information 


Argument 


status 


stream-handle 


flush-rtn 


flush-prm 


C FORMAT 


status = CdaFlushStream 
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(stream-handle ,flush-rtn ,flush-prm) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 

Access: write only 

Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 

Access: read only 

Mechanism: by reference 

VMS usage: procedure 

Data type: procedure entry mask 

Access: call after stack unwind 

Mechanism: by reference, procedure refer- 
ence 

VMS usage: context 

Data type: longword (unsigned) 

Access: read only 

Mechanism: by value 


(stream_handle, flush_rtn, flush_prm) 


FLUSH STREAM 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaFlushStream(stream_handle, 
flush_rtn, flush_prm) 


unsigned long stream_handle; 
unsigned long (*flush_rtn) (); 
unsigned long flush_prm; 


status 
A condition value indicating the return status of the routine call. 


stream-handle 
Identifier of the output stream to be flushed. This handle is returned by a call to 
the CREATE STREAM routine. 


flush-rin 

Address of a stream flush routine. If you specify 0 for this argument, a default 
flush-rtn is used. If you specify a value other than the default for this argument, 
you must also specify a value for the flush-prm argument. For more information, 
see Chapter 9. 


flush-prm 

User context to be passed to the stream flush routine. This argument should 
contain the value of the put-prm argument passed in a call to the CREATE 
STREAM routine. For more information, see Chapter 9. 


The FLUSH STREAM routine writes any buffered data to an output stream and 
ensures that the data has been physically transferred to the receiving medium. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


Any error returned by the file routines. 
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GET AGGREGATE 


Reads the next aggregate from the specified stream. 


VAX FORMAT 


status = cda$get_aggregate 


(root-aggregate-handle ,stream-handle 
,aggregate-handle ,aggregate-type) 


Argument Information 


Argument 


status 


root-aggregate-handle 


stream_handle 


aggregate-handle 


aggregate-type 
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Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 


GET AGGREGATE 


status = CdaGetAggregate 


(root_aggregate_handle, stream_handle, 
aggregate_handle, aggregate_type) 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaGetAggregate(root_aggregate_handle, 
stream_handle, aggregate _handle, 
aggregate type) 


unsigned long root_aggregate_ handle; 
unsigned long stream_handle; 
unsigned long *aggregate handle; 
unsigned long *xaggregate type; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the aggregate to be read. This 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. 


When reading aggregates using this routine, you must use the same value for | 
root-aggregate-handle consistently to read all the aggregates in the compound 
document. Once you have read all the aggregates, you cannot specify the same 
root-aggregate-handle again when calling this routine. 


stream-handle 
Identifier of the stream from which the aggregate is to be read. This handle 
is returned by a call to either the OPEN FILE routine or the OPEN STREAM 


routine. 


aggregate-handle 
Receives the handle of the retrieved aggregate. This aggregate handle is used to 
identify the retrieved aggregate to any other aggregate transfer procedure. 


aggregate-type 

Receives the aggregate type. The DDIF aggregate type symbolic codes are defined 
in the file ddif$def.h on VMS systems and in the file ddif_def.h on ULTRIX 
systems and are described in Chapter 4. The DTIF aggregate type symbolic codes 
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are defined in the file dtif$def.h on VMS systems and in the file dtif_def.h on 
ULTRIX systems and are described in Chapter 5. 


Valid aggregate types are any one of the primary DDIF or DTIF aggregates: 


Aggregate Type Meaning 
DDIF$_DSC Document descriptor 
DDIF$_DHD Document header 
DDIF$_SEG _ Document segment 
DDIF$_TXT Text content 
DDIF$_GTX General text content 
DDIF$_HRD Hard directive 
DDIF$_SFT Soft directive 
DDIF$_HRV Hard value directive 
DDIF$_SFV Soft value directive 
DDIF$_BEZ Bézier curve content 
DDIF$_LIN Polyline content 
DDIF$_ARC Arc content 
DDIF$_FAS Fill area set content 
DDIF$_IMG Image content 
DDIF$_CRF Content reference 
DDIF$_PVT Private content 
DDIF$_GLY Layout galley 
DDIF$_EOS End of segment 
DDIF$_EXT External content 
DTIF$_DSC Document descriptor 
DTIF$_HDR Document header 
DTIF$_TBL Table definition 
DTIF$_ROW Row definition 
DTIF$_CLD Cell data 


Description 


These aggregates are the only aggregates that can be returned by the GET 
AGGREGATE routine. All other aggregates are somehow connected to these 
aggregates and can be located by traversing the structure using other routines 
(such as LOCATE ITEM and NEXT AGGREGATE). If the aggregate type is 
DDIF$_EOS (end of segment), the aggregate-handle is 0 to indicate that the 
nested segment has been completed. 


The GET AGGREGATE routine reads the next primary aggregate from a 
specified stream. (The primary aggregates are listed in the description of the 
aggregate-type argument.) 
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The GET AGGREGATE routine has three restrictions on the information re- 
turned: 


¢ The GET AGGREGATE routine returns only primary aggregates (as listed 
in the description of the aggregate-type argument). Other aggregates are 
returned attached to the primary aggregates. 


¢ When you call the GET AGGREGATE routine for a segment aggregate, it re- 
turns all the items in the segment aggregate (and all its substructure) except 
for the content item (DDIF$_SEG_CONTENT) and its substructure. 


¢ When you call the GET AGGREGATE routine and it returns a DDIF$_EXT 
aggregate, the encoding items (DDIF$_EXT_ENCODING_C, DDIF$_EXT_ 
ENCODING, and DDIF$_EXT_ENCODING_L will be empty. A call to the 
GET EXTERNAL ENCODING routine must be made before the next call to 
get AGGREGATE. 


¢ Content aggregates are returned one at a time, following the segment 
aggregate. 


¢ When you are processing a document, you must observe the occurrence 
of DDIF$_EOS aggregates, which denote the end of a segment’s content. 
It is also important to note that the DDIF$_EOS aggregate is a dummy 
aggregate; it is not an actual aggregate and therefore does not have a valid 
aggregate handle. Instead, it is simply an aggregate type that is returned to 
indicate the end of a segment. The next aggregate returned is a sibling to 
that segment. 


The GET AGGREGATE routine reads the primary aggregates in a document 

in a hierarchical fashion. That is, whenever GET AGGREGATE encounters a 
segment, your next call to GET AGGREGATE descends to the next level of the 
hierarchy and reads the contents of that segment before reading the remaining 
content of the parent segment. The GET AGGREGATE routine only returns to 
the parent segment’s level of hierarchy when it encounters a DDIF$_EOS (end of 
segment) aggregate to indicate that the nested segment is completed. 


For example, consider a document that contains a document root aggregate 
(DDIF$_DDF), a document descriptor (DDIF$_DSC), a document header (DDIF$_ 
DHD), and a root segment (DDIF$_SEG) with text content (DDIF$_TXT), a 
nested segment (DDIF$ SEG), and Bézier content (DDIF$_BEZ), where the 
segment nested under the root segment contains arc content (DDIF$_ARC). This 
document is illustrated in Figure 8-1. 
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Figure 8-1: Example Document 
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Following these generalized rules, the aggregates returned by consecutive calls to 
GET AGGREGATE would be as follows: 


1. DDIF$_DSC 

DDIF$_DHD 

DDIF$_SEG (root segment) 

DDIF$_TXT 

DDIF$_SEG (segment with nested arc content) 
DDIF$_ARC (nested arc content aggregate) 


DDIF$_EOS (dummy aggregate indicating end of segment with nested arc 
content) 


DDIF$_BEZ (Bézier content) 
DDIF$_EOS (dummy aggregate indicating end of root segment) 
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RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_ENDOFDOC End of document 
CDA$_INVDOC Invalid document content 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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GET ARRAY SIZE 


Determines the number of elements present in an array-valued aggregate item. 


VAX FORMAT 
status = cda$get_array_size 
(aggregate-handle ,aggregate-item , array-size) 


Argument Information 


C FORMAT 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

aggregate-item VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

array-size VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaGetArraySize 
(aggregate_handle, aggregate_item, array_size) 
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Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaGetArraySize (aggregate _ handle, 
aggregate item, array size) 


unsigned long aggregate_handle; 
unsigned long aggregate item; 
unsigned long *array_ size; 


status 
A condition value indicating the return status of the routine call. 


aggregate-handle 
Identifier of the aggregate containing the array-valued item. 


aggregate-item 

Identifying code of the array-valued aggregate item, expressed as a symbolic 
constant. The DDIF aggregate item symbolic constants are defined in the module 
ddif$def.h on VMS systems and in the module ddif_def.h on ULTRIX systems and 
are defined in Chapter 4. The DTIF aggregate type symbolic codes are defined in 
the file dtif$def.h on VMS systems and in the file dtif_def.h on ULTRIX systems 
and are described in Chapter 5. 


array-size 

Receives the number of elements present in the array-valued item. Because the 
index is zero based, this number is equal to 1 more than the value of the highest 
valid aggregate index. 


The GET ARRAY SIZE routine determines the number of elements present in an 
array-valued aggregate item. 
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RETURN VALUES 


Return Value 
CDA$_NORMAL 
CDA$_INVAGGTYP 
CDA$_INVITMCOD 
CDA$_EMPTY 
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Description 

Normal successful completion. 
Invalid aggregate type. 
Invalid item code. 


Item is empty. 


GET DOCUMENT 


GET DOCUMENT 


Reads an entire compound document from the specified stream. 


VAX FORMAT 


status = cda$get_document 
(root-aggregate-handle ,stream-handle) 


Argument Information 


C FORMAT 


Argument 


status 


root-aggregate-handle 


stream-handle 


status = CdaGetDocument 
(root_aggregate_handle, stream_handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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Argument Information 


unsigned long CdaGetDocument (root_aggregate_handle, 
stream_handle) 
unsigned long root_aggregate_handle; 
unsigned long stream_handle; 


RETURNS 
status 
A condition value indicating the return status of the routine call. 
Arguments 
root-aggregate-handle 
Identifier of the root aggregate associated with the document to be read. This 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. | 
Once you read an entire document, you cannot call the GET DOCUMENT routine 
specifying the same root aggregate handle again. That is, you can only read a 
document associated with a particular root aggregate once. 
stream-handle 
Identifier of the stream from which the document is to be read. This handle 
is returned by a call to either the OPEN FILE routine or the OPEN STREAM 
routine. 
Description 


The GET DOCUMENT routine reads an entire document from the specified 
stream. This routine is used by a front end module to read an entire compound 
document file into memory. 


Upon completion of the call to this routine, the entire document is present in 
memory in aggregates that are linked from the document root aggregate. 
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RETURN VALUES 


Return Value Description 

CDA$_ NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 
CDA$_INVDOC Invalid document content 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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GET EXTERNAL ENCODING 


Reads the value of an external encoding from the specified stream and stores it as 
the value of the agg$_EXT_ENCODING item in the appropriate aggregate, which 
can be DDIF$_EXT, DTIF$_EXT, or ESF$_EXT. 


VAX FORMAT 
status = cda$get_external_encoding 


(root-aggregate-handle ,stream-handle 


,aggregate-handle) 
Argument Information 
Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
stream-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: modify 
Mechanism: by reference 
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GET EXTERNAL ENCODING 


status = CdaGetExternalEncoding 


(root_aggregate_handle, stream_handle, 
aggregate_handle) 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaGetExternalEncoding (root_aggregate_handle, 
stream handle, aggregate_handle) 


unsigned long root_aggregate_handle; 
unsigned long stream handle; 
unsigned long *aggregate handle; 


Status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 
Identifier of the root aggregate. This handle is returned by a call to either the 
OPEN FILE routine or the CREATE ROOT AGGREGATE routine. 


stream-handle 
Identifier of the stream containing the external encoding. This handle is returned 
by a call to either the OPEN FILE routine or the OPEN STREAM routine. 


aggregate-handle 

Identifier of an aggregate of type DDIF$_EXT, DTIF$_EXT, or ESF$_EXT. The 
external encoding value that is read from the stream is written to the agg$_EXT_ 
ENCODING item in the appropriate aggregate, where agg refers to the specific 
ageregate type. That aggregate becomes the root aggregate for the external 
document. 


The GET EXTERNAL ENCODING routine reads the value of an external en- 
coding and stores the value in the agg$_ EXT_ENCODING item of the aggregate 
specified by aggregate-handle, which can be an aggregate of type DDIF$_EXT, 
DTIF$_EXT, or ESF$_EXT. If the external encoding is DDIF or DTIF, the value 
stored is the handle of a DDIF or DTIF root aggregate, which contains the entire 
document in the external encoding. 
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If used, the GET EXTERNAL ENCODING routine must be invoked immediately 
after the specified aggregate has been returned by the GET AGGREGATE 
routine. Alternatively, the caller can read the DDIS encoding of an inner 


document by calling the 
aggregate. 


RETURN VALUES 


Return Value 


CDA$_NORMAL 
CDA$_INVDOC 
CDA$_INVAGGTYP 
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Description 

Normal successful completion 
Invalid document 

Invalid aggregate type 


GET STREAM POSITION 


GET STREAM POSITION 


Returns the current position in and size of a CDA data stream. 


VAX FORMAT 


status = cda$get_stream_position 


Argument Information 


Argument 


status 


stream-handle 


position-rtn 


position-prm 


stream-position 


(stream-handle ,position-rtn ,position-prm 
,stream-position ,stream-size) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: procedure 

Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference 

VMS usage: context 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
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Argument 


stream-size 


C FORMAT 


Argument Information 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaGetStreamPosition 


(stream_handle, position_rtn, position_prm, 
stream_position, stream_size) 


Argument Information 


unsigned long CdaGetStreamPosition(stream_handle, 
position_rtn, position_prm, 
stream position, stream_size) 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


RETURNS 


status 


long 
long 
long 
long 
long 


stream_handle; 
(*posi.tiaon: ren) ();7 
position prm; 
*stream_position; 
*stream_size; 


A condition value indicating the return status of the routine call. 


Arguments 
stream-handle 


Identifier of the stream. The handle is returned by a call to either the OPEN 
STREAM routine or the OPEN FILE routine. 


position-rin 


Address of a get-position routine. The calling sequence for a get-position routine 
is defined in Chapter 11. If you specify 0 for this argument, the CDA Toolkit 
provides a default get-position routine. If you specify a value other than the 
default for this parameter, you must also specify a value for the position-prm 


argument. 
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GET STREAM POSITION 


position-prm 

User context to be passed to the get-position routine. This argument should 
contain the value of the get-prm argument passed in a call to the OPEN 
STREAM or CREATE STREAM routine, or the value of the file handle in a call 
to the OPEN FILE or CREATE FILE routine. If you specify a value for the 
position-rtn argument, you must also specify a value for this argument. 


stream-position 
Receives the current position (in bytes) as measured from the start of the input 
stream being processed. 


stream-size 
Receives the total size (in bytes) of the input stream being processed. 


The GET STREAM POSITION routine returns the current position and total size 
of the CDA data stream being processed. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
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GET TEXT POSITION 


Returns the current position in and size of a text file. 


VAX FORMAT 


status = cda$get_text_position 
(file-handle , file-position ,file-size) 


Argument Information 


Argument 


status 


file-handle 


file-position 


file-size 


C FORMAT 
status = CdaGetTextPosition 


Argument Information 

VMS ‘usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


(file_handle, file_position, file_size) 
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Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaGetTextPosition(file handle, 
file position, file size) 


unsigned long file handle; 
unsigned long *file position; 
unsigned long *file_ size; 


Status 
A condition value indicating the return status of the routine call. 


file-handle 
Identifier of the text file being processed. This handle is returned by a call to the 
OPEN TEXT FILE routine. 


file-position 
Receives the current position (in bytes) as measured from the start of the input 
text file being processed. 


file-size 
Receives the total size (in bytes) of the text file being processed. 


The GET TEXT POSITION routine returns the current position in and total size 
of an input text file being processed. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 
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INSERT AGGREGATE 


Inserts an aggregate into a sequence. The location at which the aggregate is to 
be inserted is determined by specifying the preceding aggregate in the sequence. 


VAX FORMAT 
status = cda$insert_aggregate 


Argument Information 


C FORMAT 


Argument 


status 


aggregate-handle 


prev-aggregate-handle 


(aggregate-handle ,prev-aggregate-handle) 


Argument Information 


VMS usage: 
Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 
Access: 


Mechanism: 


status = CdalnsertAggregate 
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cond_value 
longword (unsigned) 
write only 


by value 


identifier 
longword (unsigned) 
read only 


by reference 


identifier 

longword (unsigned) 
read only 

by reference 


(aggregate_handle, prev_aggregate_handle) 


INSERT AGGREGATE 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaInsertAggregate (aggregate handle, 
prev_aggregate_handle) 
unsigned long aggregate handle; 
unsigned long prev_aggregate_handle; 


status 
A condition value indicating the return status of the routine call. 


aggregate-handle 
Identifier of the aggregate to be inserted into the sequence. 


prev-aggregate-handle 
Identifier of the aggregate after which the aggregate identified by aggregate- 
handle is to be inserted in the sequence. 


The INSERT AGGREGATE routine inserts an aggregate into a sequence. The 
location at which the aggregate is to be inserted is indicated by specifying the 
preceding aggregate in the sequence. 


If the aggregate indicated by aggregate-handle is the first aggregate in its 
own sequence, this entire sequence is inserted into the sequence containing the 
aggregate specified by prev-aggregate-handle. If the aggregate specified as 
aggregate-handle is part of a sequence but is not the first aggregate in that 
sequence, or if it is the value of an item, an error is returned. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVINSERT Aggregate already in a sequence 
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Example 


8-110 


This example illustrates the use of the INSERT AGGREGATE routine to insert 
an aggregate into a sequence. 


aggregate _type = DDIF$ PTH; 

status = cda$create_aggregate (&root_aggregate_handle, 
&aggregate type, 
&inner_aggregate_handle); 

if (FAILURE (status)) return(status); 


aggregate item = DDIF$ SGA_FRM OUTLINE; 

item_length = 4; 

status = cda$store_item(&root_aggregate_ handle, é&aggregate_handle, 
&aggregate_item, &item_length, 
&inner_aggregate handle); 

if (FAILURE (status)) return(status); 


aggregate_item = DDIFS$_ PTH C; 
local_length = sizeof (integer_value) ; 
integer value = DDIF$K_PATH_REFERENCE; 
status = cda$store_item(&root_aggregate_handle, 
&inner_ aggregate handle, 
&aggregate_ item, 
&local_ length, &integer value); 
if (FAILURE (status)) return(status); 


aggregate _item = DDIF$ PTH REFERENCE; 

local_length = sizeof (integer value); 

integer value = 1; 

status = cdaSstore _item(&root_aggregate_handle, 
&inner_aggregate_handle, 
&aggregate item, 
&local length, &integer value); 

if (FAILURE (status)) return(status); 


aggregate _type = DDIFS_PTH; 

status = cdaScreate aggregate (&root_aggregate_ handle, 
é&aggregate type, 
&inner_aggregate_handle 2); 

if (FAILURE (status)) return(status) ; 


status = cda$insert_aggregate(&inner_aggregate_handle 2, 
&inner aggregate handle); 
if (FAILURE(status)) return(status) ; 


aggregate _item = DDIF$ PTH C; 
local_length = sizeof (integer value); 
integer value = DDIF$K_PATH BEZIER; 
status = cda$store_item(&root_aggregate_ handle, 
&inner aggregate handle 2, 
é&aggregate_ item, 
&local_length, &integer value); 
if (FAILURE(status)) return(status) ; 
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aggregate item = DDIF$ PTH BEZ PATH C; 

local_length = sizeof (integer value); 

integer value = DDIFSK_VALUE_CONSTANT; 

aggregate index = 0; 

status = cdaS$store _item(&root_aggregate_handle, 
&inner aggregate handle 2, 
&aggregate_item, &local_length, 
&integer value, &aggregate_index) ; 

if (FAILURE(status)) return(status); 


aggregate item = DDIFS_PTH BEZ PATH; 

local_length = sizeof (integer_value) ; 

integer value = 20; 

aggregate index = 0; 

status = cda$store_item(&root_aggregate_handle, 
&inner_ aggregate handle 2, 
&aggregate_ item, 
&local_length, é&integer_ value, 
&aggregate_index) ; 

if (FAILURE (status)) return(status); 
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LEAVE SCOPE 


Completes a document that was incrementally written. 


VAX FORMAT 
status = cda$leave_scope 


(root-aggregate-handle ,stream-handle 
,scope-code) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
stream-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
scope-code VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


C FORMAT 


status = CdaLeaveScope 


(root_aggregate_handle, stream_handle, 
scope_code) 
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Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaLeaveScope (root_aggregate_handle, 
stream handle, scope_code) 


unsigned long root_aggregate handle; 
unsigned long stream_handle; 
unsigned long scope code; 


Status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the document being incrementally 
written. This handle is returned by a call to either the OPEN FILE routine or 
the CREATE ROOT AGGREGATE routine. 


stream-handle 

Identifier of the stream associated with the document being incrementally 
written. This handle is returned by a call to either the CREATE FILE routine or 
the CREATE STREAM routine. 


scope-code 
Symbolic constant identifying the scope to be completed. Valid values are as 
follows: 


Code Meaning 
DDIF$K_DOCUMENT_SCOPE Document scope 
DDIF$K_CONTENT_SCOPE Content scope 
DDIF$K_SEGMENT_SCOPE Segment scope 
DTIF$K_DOCUMENT_SCOPE Document scope 
DTIF$K_TABLE_SCOPE Table scope 
DTIF$K_ROW_SCOPE Row scope 
DTIF$K_CELLS_SCOPE Cell scope (for all cells in a row) 


The LEAVE SCOPE routine completes a compound document that was incremen- 
tally written. For more information on incremental writing of documents, see the 
description for the ENTER SCOPE routine. 
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RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVSCOCOD Invalid scope code 


Any errors returned by the file routines. 
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LOCATE ITEM 


Locates an item within an aggregate by returning its address. 


VAX FORMAT 
status = cda$locate_item 


(root-aggregate-handle ,aggregate-handle 
,aggregate-item ,item-address ,item-length 
[Laggregate-index] [,add-info]) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-item VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
item-address VMS usage: address 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
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Argument Argument Information 

item-length VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

aggregate-index VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

add-info VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read or write 
Mechanism: by reference 


C FORMAT 
status = CdaLocateltem 
(root_aggregate_handle, aggregate_handle, 
aggregate_item, item_address, item_length, 
aggregate_index, add_info) 


Argument Information 


unsigned long CdaLocateItem(root_aggregate_handle, 
aggregate handle, aggregate_item, 
item_address, item_length, 
aggregate_index, add_info) 


unsigned long root_aggregate handle; 
unsigned long aggregate handle; 
unsigned long aggregate item; 
unsigned char *item_address; 
unsigned long *xitem_length; 
unsigned long aggregate index; 
unsigned long *add_info; 


RETURNS 


Status 
A condition value indicating the return status of the routine call. 
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LOCATE ITEM 


root-aggregate-handle 

Identifier of the root aggregate with which the aggregate containing the item to 
be located is associated. This identifier is returned by a call to either the OPEN 
FILE routine or the CREATE ROOT AGGREGATE routine. 


You must use identical memory management procedures when storing and 
locating an item within an aggregate, to ensure consistent treatment of memory 
allocation and deallocation. 


aggregate-handle 
Identifier of the aggregate containing the item to be located. 


aggregate-item 

Identifying code of the item, expressed as a symbolic constant. The DDIF 
aggregate item symbolic constants are defined in the file ddif$def.h on VMS 
systems and in the file ddif_def.h on ULTRIX systems and are described in 
Chapter 4. The DTIF aggregate type symbolic codes are defined in the file 
dtif$def.h on VMS systems and in the file dtif_def.h on ULTRIX systems and are 
described in Chapter 5. 


A user context item named DDIF$_USER_CONTEXT for DDIF aggregates 
and DTIF$_USER_CONTEXT for DTIF aggregates is available within every 
aggregate. This item is a longword that can be used by the application for any 
purpose. 


For use by applications, a DDIF$_AGGREGATE_TYPE item and a DTIF$_ 
AGGREGATE_TYPE item are defined for every DDIF and DTIF aggregate type, 
respectively. It is a read-only item and, consequently, may be located using 
only this routine. If you specify this aggregate item, it returns the type of the 


aggregate. 


item-address 

Receives the address of the item’s value. This storage area can only be read by 
the calling program; that is, it is read-only. The returned item-address is valid 
until either the STORE ITEM or the ERASE ITEM routine is called for any item 
in the aggregate, or until the aggregate is deleted. 


If the item being located contains an aggregate handle, a call to this routine 
returns the address of the aggregate handle. In order to use this aggregate 
handle, you must “dereference” it. For example, in C you would do the following: 


cda$locate item(&root_agg handle, &agg_handle, é&agg_item, 
&sub_agg, &item_length, é&agg_index, &add_info); 


The sub_agg parameter receives the address of the aggregate handle of the 
subaggregate. To use this handle, you would do the following: 
agg_handle = *sub_agg; 
cdaS$locate item(&root_agg handle, &agg_ handle, &agg_item, 
&buf_ addr, é&buf_length, &agg_index, &add_info); 


If there are subsequent aggregates in a sequence, you should use the NEXT 
AGGREGATE routine to retrieve the subsequent aggregates. 


CDA Toolkit Routines 8-117 


LOCATE ITEM 


Description 


item-length 
Receives the length (in bytes) of the item’s value. 


aggregate-index 

Index of the item (relative to 0). This argument is required whenever the notation 
“Array of” appears in the data type of the specified item handle. Otherwise, this 
argument is only required if the add-info argument is also required. 


add-info 

Receives a data type-specific modifier for the data types character string and 
string with add-info. Selects the floating-point format to be returned for items 
with the data type general floating-point. Receives an integer scaling factor for 
the data type scaled integer. For data types other than character string, string 
with add-info, general floating-point, and scaled integer, this argument is not 
written and may be omitted. 


For the data type character string, the add-info parameter receives the character 
set designator. For the data type string with add-info, if the string value is 
equal to one of the standard tag values, the add-info parameter receives a value 
that identifies the tag. For the data type scaled integer, the add-info parameter 
receives an integer scaling factor. For the data type general floating-point, the 
add-info parameter contains a value that selects the format for the floating-point 
value to be returned. For add-info values for the general floating-point type, see 
Table 1-1. Otherwise, add-info receives a value that indicates that the tag is 
private. 


The LOCATE ITEM routine determines the address of an item within an 
aggregate. 


If the located item is encoded as the handle of an aggregate, you receive the 
address of the aggregate handle. To use this handle in subsequent routine calls, 
you must first “dereference” it. (For more information, see the description of the 
item-address argument.) 


If the located item is encoded as an “Array of”, the user must call the GET ARRAY 
SIZE routine to determine the array size, and then use the LOCATE ITEM 
routine to read each item in the array by incrementing the aggregate-index 
argument. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion. 
CDA$_INVAGGTYP Invalid aggregate type. 
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Return Value 


CDA$_INVITMCOD 
CDA$_EMPTY 
CDA$_INDEX 
CDA$_VAREMPTY 
CDA$_VARINDEX 
CDA$_VARVALUE 
CDA$_DEFAULT 


LOCATE ITEM 


Description 


Invalid item code. 

Item is empty. 

Index exceeds array bounds. 
Variant item is empty. 
Variant index exceeds bounds. 
Variant value is undefined. 


Value returned is either a default value that is not in the data 
stream or is an inherited value if inheritance is enabled for the 
root aggregate. 
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NEXT AGGREGATE 


Locates the next aggregate in an aggregate sequence. 


VAX FORMAT 


status = cda$next_aggregate 
(aggregate-handle ,next-aggregate-handle) 


Argument Information 


Argument 


status 


aggregate-handle 


next-aggregate-handle 


C FORMAT 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaNextAggregate 
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(aggregate_handle, next_aggregate_handle) 


NEXT AGGREGATE 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaNextAggregate (aggregate handle, 
next_aggregate_ handle) 
unsigned long aggregate_ handle; 
unsigned long *next_aggregate_ handle; 


Status 
A condition value indicating the return status of the routine call. 


aggregate-handle 
Identifier of the aggregate to be used in locating the next aggregate. 


next-aggregate-handle 

Receives the handle of the aggregate that follows the aggregate specified by 
aggregate-handle. If the aggregate specified by aggregate-handle is the last 
aggregate in the sequence, next-aggregate-handle receives a value of 0. 


The NEXT AGGREGATE routine locates the next aggregate in a sequence 

of aggregates. This aggregate is located using the preceding aggregate as a 
reference. (The preceding aggregate is specified by the aggregate-handle 

argument.) 


To read the aggregates in a sequence, you must retrieve the aggregate handle 
of the first aggregate using the LOCATE ITEM routine. (The handle of the 
first aggregate in the sequence is stored as an item in the current aggregate.) 
Once you have located the first item in the sequence using the LOCATE ITEM 
routine, you can use the NEXT AGGREGATE routine to retrieve each additional 
aggregate in the sequence. All aggregates in the sequence have been retrieved 
when the status CDA$_ENDOFSEQ is returned. 


For example, the DDIF$_CRF_TRANSFORM item in the DDIF$_CRF aggregate 
is encoded as a sequence of DDIF$_TRN aggregates. To access the sequence 

of DDIF$_TRN aggregates, you would first use the LOCATE ITEM routine to 
read the handle of the first DDIF$_TRN aggregate that is stored in the DDIF$_ 
CRF_TRANSFORM item. You would then use the NEXT AGGREGATE routine 
to return each additional aggregate in this encoded sequence, until the status 
CDA$_ENDOFSEQ is returned. 
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If you are interested in retrieving aggregates from a particular input stream that 
are not encoded as a sequence, refer to the description of the GET AGGREGATE 
routine. 


NOTE 


If several different aggregate types may be linked in sequence, locate 
the aggregate type for the aggregate to determine its type (DDIF$_ 
AGGREGATE_TYPE item code). 


RETURN VALUES 
Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_ENDOFSEQ No successor aggregate found 
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OBJECT ID TO AGGREGATE TYPE 


Translates an object identifier to a root aggregate type. 


VAX FORMAT 
status = cda$object_id_to_aggregate_type 
(buf-len ,buf-adr ,nam-len ,nam-adr ,act-nam-len 
,aggregate-type) 


Argument Information 


Argument Argument Information 


status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
buf-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
buf-adr VMS usage: array 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference, array reference 
nam-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
nam-adr VMS usage: array 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference, array reference 
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Argument Argument Information 

act-nam-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

aggregate-type VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 
status = CdaObjectldToAggregateType 
(buf_len, buf_adr, nam_len, nam_adr, act_nam_len, 
aggregate_type) 


Argument Information 


unsigned long CdaObjectIdToAggregateType (buf_len, 
buf_adr, nam_len, nam_adr, 
act_nam_len, aggregate_type) 


unsigned long buf_len; 
unsigned long buf_adr[]; 
unsigned long nam_len; 
unsigned char *nam_adr; 
unsigned long *act_nam_len; 
unsigned long *aggregate type; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 


Arguments 


buf-len 
Length (in bytes) of the object identifier buffer. 


buf-adr 
Address of the object identifier. 
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nam-len 
Length (in bytes) of the domain name buffer. 


nam-adr 
Receives the address of the domain name buffer. 


act-nam-len 
Receives the actual length (in bytes) of the domain name in the nam-adr buffer. 


aggregate-type 
Receives the translated aggregate type. 


Description 


The OBJECT ID TO AGGREGATE TYPE routine translates an object identifier 
to a root aggregate type. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 
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OPEN CONVERTER 


Activates a front end to process nested content, which can be in the same format 


as the current document or in a different format. 


VAX FORMAT 


status = cda$open_converter 


Argument Information 


Argument 


status 


standard-item-list 


converter-context 


front-end-handle 


C FORMAT 


status = CdaOpenConverter 
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(standard-item-list ,converter-context 
,front-end-handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: item_list_2 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference, array reference 
VMS usage: context 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


OPEN CONVERTER 


(standard_item_list, converter_context, 
front_end_handle) 


Argument Information 


unsigned long CdaOpenConverter (standard_item_list, 
converter context, front _end_handle) 


unsigned long *standard_item_list; 
unsigned long converter context; 
unsigned long *front_end_handle; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 





Arguments 


standard-item-list 
An item list that identifies the document source and destination, and can also 
contain options to control processing. 


Each entry in the item list is a 2-longword structure with the following format: 


buffer address 


To terminate the item list, you must specify the final entry or longword as 0. 
Valid code values for the items in the standard-item-list are as follows: 






CDA$_INPUT_FORMAT 
The parameter is the address and length of a string that specifies the input 
document format. 


CDA$_INPUT_FRONT_END_PROCEDURE 

The parameter is the address of the main entry point in the front end, 
either ddif$read_format or dtif$read_format. The item list length field 
must be 0. This item enables a caller to provide a front end that is part of 
the calling application rather than a separate image. If this item code is 
used, the CDA$_INPUT_FILE item can be used to pass any information (not 
necessarily a file specification) to the front end. 
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CDA$_INPUT_FRONT_END_DOMAIN 
The parameter is the address and length of a string that specifies the input 
document domain (either DDIF or DTIF). 


CDA$_INPUT_FILE 
The parameter is the address and length of the file specification of the input 
document. 


CDA$_INPUT_DEFAULT 

The parameter is the address and length of the default file specification of the 
input document. If this parameter is omitted, the front end must supply an 
appropriate backup default file specification. 


CDA$_INPUT_PROCEDURE 

The parameter is the address of a procedure to provide input. The item list 
length field must be 0. The input procedure must conform to the requirements 
for a get routine. The calling sequence for a user get routine is defined in 
Chapter 9. 


CDA$_INPUT_PROCEDURE_PARM 
The parameter is the address of a longword parameter to the input procedure. 
The item list length field must be 4. 


CDA$_INPUT_POSITION_PROCEDURE 

The parameter is the address of a procedure that provides position informa- 
tion. The item list length field must be set to 0. For more information on the 
calling sequence for a user get routine, see Chapter 9. 


CDA$_INPUT_ROOT_AGGREGATE 

The parameter is the address of a longword handle to a root aggregate that 
specifies an in-memory input document. The item list length field must be 
4. The in-memory structure, except for the root aggregate itself, is erased by 
this operation. The root aggregate must specify standard memory allocation. 


converter-context 
Context value passed as a parameter to the ddif$read_format or dtif$read_ 
format entry point in the front end. 


front-end-handle 
Receives the handle of the front end that will process the nested content. This 
handle must be used in all subsequent operations relating to that front end. 


ee 


Description 


The OPEN CONVERTER routine activates an additional front end to process 
nested content that is an entire document. The nested content may be in the 
same format as that of the main document or in a different format. 


Processing options that were specified at the main conversion call (either from 
the command line or by the CONVERT routine) for this document format are 
automatically retrieved and appended to the standard item list to create a front 
end item list that is then passed to the front end’s main entry point. 
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RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_UNSUPFMT Unsupported document format 


Any error returned by the specific front end. 
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OPEN FILE 


Opens the specified file for input and validates that its initial contents are valid 
compound document data. An input stream and a root aggregate are also created. 


VAX FORMAT 
status = cda$open_file 

(file-spec-len ,file-spec ,default-file-spec-len 
,default-file-spec ,alloc-rtn ,dealloc-rtn 
,alloc-dealloc-prm ,aggregate-type 
,Processing-options ,result-file-spec-len 
,result-file-spec ,result-file-ret-len ,stream-handle 
,file-handle ,root-aggregate-handle) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

file-spec VMS usage: char_string 
Data type: character string 
Access: read only 
Mechanism: by reference 

default-file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
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Argument 
default-file-spec 


alloc-rtn 


dealloc-rtn 


alloc-dealloc-prm 


aggregate-type 


processing-options 


result-file-spec-len 


result-file-spec 


OPEN FILE 


Argument Information 

VMS usage: char_string 

Data type: character string 
Access: read only 
Mechanism: by reference 

VMS usage: procedure 

Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference 

VMS usage: procedure 

Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference. 

VMS usage: context 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: item_list_2 

Data type: record 

Access: read only 

Mechanism: by reference, array reference 
VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 

Mechanism: by reference 

VMS usage: char_string 

Data type: character string 
Access: write only 
Mechanism: by reference 
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Argument 
result-file-ret-len 


stream-handle 


file-handle 


root-aggregate-handle 


C FORMAT 


Argument Information 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status = CdaOpenFile 


Argument Information 
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(file_spec_len, file_spec, default_file_spec_len, 
default_file_spec, alloc_rtn, dealloc_rtn, 
alloc_dealloc_prm, aggregate_type, 
processing_options, result_file_spec_len, 
result_file_spec, result_file_ret_len, stream_handle, 
file_handle, root_aggregate_handle) 


RETURNS 


Arguments 


OPEN FILE 


unsigned long CdaOpenFile(file spec _len, file spec, 
default _file_spec_len, default_file spec, 
alloc_rtn, dealloc_rtn, alloc _dealloc_prm, 
aggregate type, processing options, 
result file spec_len, result _file_ spec, 
result_file ret_len, stream_handle, 
file handle, root_aggregate_handle) 


unsigned long file _spec_len; 
unsigned char *file spec; 

unsigned long default _file_spec_len; 
unsigned char *default_file_ spec; 
unsigned long (*alloc rtn)() 7 
unsigned long (*dealiloe ttn) .{) 7 
unsigned long alloc dealloc_prm; 
unsigned long aggregate type; 
unsigned long *processing options; 
unsigned long result _file spec_len; 
unsigned char *result_file spec; 
unsigned long “result. file ret Len; 
unsigned long *stream_handle; 
unsigned long *file handle; 

unsigned long *root_aggregate_ handle; 


Status 
A condition value indicating the return status of the routine call. 


file-spec-len 
The length of the string specified by the file-spec parameter. 


file-spec 
The file specification. 


default-file-spec-len 

The length (in bytes) of the buffer specified by default-file-spec. If you specify an 
address of 0 for both the default-file-spec-len and default-file-spec arguments, 
a default file specification of “.ddif’ is used. 


default-file-spec 

The default file specification. In order to simplify the porting of applications, the 
character string should consist of only a file type in lowercase characters. If you 
specify an address of 0 for both the default-file-spec-len and default-file-spec 
arguments, a default file specification of “.ddif’ is used. On ULTRIX systems, the 
string is appended to the file specification, if the file specification does not already 
contain a period. 


alloc-rtn 

Address of a memory allocation routine. The calling sequence for an allocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory allocation routine is used. For a description, see 
Chapter 9. 
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dealloc-rin 

Address of a memory deallocation routine. The calling sequence for a deallocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory deallocation routine is used. For a description, 
see Chapter 9. 


alloc-dealloc-prm 

User context to be passed to the memory allocation and deallocation routines. If 
the system default memory allocation or deallocation procedure is used, this value 
is ignored. For a description, see Chapter 9. 


aggregate-type 
The type of aggregate, expressed as a symbolic constant. The only valid root 
aggregate types are DDIF$_DDF and DTIF$_DTF. 


processing-options 

An item list containing options to control processing. Each entry in the item list 
is a 2-longword structure; to terminate the item list you must specify a final entry 
or longword of zero. Valid item codes are as follows: 


DDIF$_INHERIT_ATTRIBUTES Inheritance is applied to all document seg- 
ments. First, if a segment has a type refer- 
ence that corresponds to a type definition, 
the attributes of the type are applied to the 
segment. 


If a segment is the root segment, and a style 
guide is referenced in the document’s header, 
the definitions and layout from the style guide 
are applied to the root segment. For the root 
segment only, standard defined initial values 
are applied to the attributes of the segment 
that do not yet have values. 


If the segment is not the root segment, at- 
tribute values of its parent segment are 
applied to the attributes of the segment that 
do not yet have values. For more information 
on the inherit attributes processing option, see 
Section 1.6.1. 


DDIF$_RETAIN_DEFINITIONS Segment definitions that enable the operation 
of CDA$FIND_DEFINITION are retained. 
This item code is required only if neither 
DDIF$_INHERIT_ATTRIBUTES nor DDIF$_ 
EVALUATE_CONTENT is specified. For 
more information on the retain definitions 
processing option, see Section 1.6.2. 

DDIF$_EVALUATE_CONTENT Content reference (DDIF$_CRF) aggregates 
are replaced with the value of the definition 
(DDIF$_CTD) they reference. The value of 
this content definition may be in the document 
or in an external reference. 
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Content for segments with the DDIF$_SGA_ 
COMPUTE_C item present in the segment’s 
attributes (DDIF$_SGA) may be imported 
from an external reference. If the value 

of the DDIF$_SGA_COMPUTE_C item is 
DDIF$K_REMOTE_COMPUTE, the external 
content is imported and replaces the segment’s 
original content. If the value of the DDIF$_ 
SGA_COMPUTE_C item is DDIF$_K_COPY_ 
COMPUTE, the external content is imported 
only if the segment has no content. For more 
information on the evaluate content processing 
option, see Section 1.6.3. 


DDIF$_DISCARD_I_SEGMENTS Segments of the image ($1) content category, 
and any nested segments, are discarded. 
For more information on the discard image 
segments processing option, see Section 1.6.4. 

DDIF$_DISCARD_2D_ SEGMENTS Segments of the graphics ($2D ) content cate- 
gory, and any nested segments, are discarded. 
For more information on the discard graphics 
segments processing option, see Section 1.6.4. 


DDIF$_DISCARD_T_SEGMENTS Segments of the text ($T) content category, 
and any nested segments, are discarded. For 
more information on the discard text segments 
processing option, see Section 1.6.4. 

DDIF$_DISCARD_TBL_SEGMENTS Segments of the table ($TBL) content cate- 
gory, and any nested segments, are discarded. 
For more information on the discard table 
segments processing option, see Section 1.6.4. 

DDIF$_DISCARD_PDL_SEGMENTS Segments of the page description language 
($PDL) content category, and any nested seg- 
ments, are discarded. For more information 
on the discard page descriptions language 
segments processing option, see Section 1.6.4. 


result-file-spec-len 
Length of the buffer (in bytes) specified by result-file-spec. If you specify 0 for 
this parameter, the resultant file specification length is not returned. 


result-file-spec 

Receives the resultant file specification. If you specify 0 for this parameter, the 

resultant file specification is not returned. This file specification is the result of 
a VMS RMS $OPEN operation. On ULTRIX systems, the file-spec argument is 
copied to this buffer. 


result-file-ret-len 
Receives the actual length (in bytes) of the resultant file specification. 


stream-handle 
Receives a value that identifies the newly created stream. This handle must be 
used in all subsequent operations on that stream. 


file-handle 
Receives a value that identifies the newly opened file. This handle must be used 
in all subsequent operations on that file. 
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root-aggregate-handle 
Receives a value that identifies the newly created root aggregate. This handle 
must be used in all subsequent operations on that root aggregate. 


Description 


The OPEN FILE routine opens a file for input and validates that the initial 
contents of the file are compound document data. At the same time, this routine 
also creates an input stream and a root aggregate. 


RETURN VALUES 


-Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVAGGTYP Invalid aggregate type 


CDA$_INVITMLST Invalid item list 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 


Example 


This example illustrates a typical call to the OPEN FILE routine. Following 
a call to this routine, the file is read using the GET DOCUMENT routine and 
subsequently closed. 


/* Open the file for input */ 


aggregate type = DDIF$ DDF; 

status = cda$open_file(&filename_length, 
é&étestl_ filename[0], 
0, 

Tv 

tf 


a 


oo0o°o 


tA 
éaggregate type, 
éresult_file_spec_len, 
&result_file_ spec[0], 
&result_file ret_len, 
&stream_handle, 
&file handle, 
é&root_aggregate_handle ); 
if (FAILURE (status)) return(status) ; 
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/* Read the entire document in, then close the file */ 

printf ("Reading document...\n"); 

status = cda$get_document (&root_aggregate_handle, 
&stream handle); 

if (FAILURE (status)) return(status); 


status = cda$close_file(&stream_handle, &file_ handle); 
if (FAILURE(status)) return(status) ; 
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OPEN STREAM 


Opens a compound document stream for input. 


VAX FORMAT 
status = cda$open_stream 


(alloc-rin ,dealloc-rtn ,alloc-dealloc-prm ,get-rtn 
,get-prm ,stream-handle) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
alloc-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference 
dealloc-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference 
alloc-dealloc-prm VMS usage: context 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 
get-rtn VMS usage: procedure 
Data type: procedure entry mask 
Access: call after stack unwind 
Mechanism: by reference 
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Argument 
get-prm 


stream-handle 


status = CdaOpenStream 
(alloc_rtn, dealloc_rtn, alloc_dealloc_prm, get_rtn, 


get_prm, stream_handle) 


Argument Information 


RETURNS 


Arguments 


OPEN STREAM 


Argument Information 

VMS usage: context 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


unsigned long CdaOpenStream(alloc_rtn, dealloc_rtn, 
alloc_dealloc_prm, get_rtn, 


get_prm, stream_handle) 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


status 


long 
long 
long 
long 
long 
long 


(*alloc_rtn) (); 
(*dealloc_rtn) (); 
alloc_dealloc_prm; 
(*get_rtn) (); 


get_prm; 


*stream_handle; 


A condition value indicating the return status of the routine call. 


alloc-rtn 


Address of a memory allocation routine. The calling sequence for an allocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory allocation routine is used. For a description, see 


Chapter 9. 
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dealloc-rin 

Address of a memory deallocation routine. The calling sequence for a deallocation 
routine is defined in the Description section of this routine. If you specify 0 for 
this argument, a default memory deallocation routine is used. For a description, 
see Chapter 9. 


alloc-dealloc-prm 

User context to be passed to the memory allocation and deatioeatan routines. 
If the system default memory allocation or deallocation routine is used, this 
parameter is ignored. For a description, see Chapter 9. 


get-rtn 

Address of a stream get routine. The calling sequence for a get routine is defined 
in Chapter 9. If you specify 0 for this argument on VMS systems, a default 
get-rtn is used. On ULTRIX systems, you must supply both get-rtn and 

get-prm; there is no default. If you specify a value other than the default for this 
argument, you must also specify a value for the get-prm argument. 


get-prm 

User context to be passed to the stream get routine. If the VMS system default 
get routine is used, the value must be a pointer to a RAB. On ULTRIX systems, if 
you specify a value for the get-rtn, you must supply a value other than 0 for the 
get-prm argument. For a description, see Chapter 9. 


stream-handle 
Receives a value that identifies the newly created stream. This handle must be 
used in all subsequent operations on that stream. 


Description 


The OPEN STREAM routine opens a compound document stream for input. 
The number of streams that you can open simultaneously is limited only by the 
amount of memory available. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 


Any error returned by the memory allocation routines. 
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OPEN TEXT FILE 


Opens a standard text file for input. 


VAX FORMAT 
status = cda$open_text_file 
(file-spec-len , file-spec ,default-file-spec-len 
,default-file-spec ,result-file-spec-len 
,result-file-spec ,result-file-ret-len ,text-file-handle) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
file-spec VMS usage: char_string 
Data type: character string 
Access: read only 
Mechanism: by reference 
default-file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
default-file-spec VMS usage: char_string 
Data type: character string 
Access: read only 
Mechanism: by reference 
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Argument Argument Information 
result-file-spec-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
result-file-spec VMS usage: char_string 
Data type: character string 
Access: write only 
Mechanism: by reference 
result-file-ret-len VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
text-file-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 
status = CdaOpentTextFile 


(file_spec_len, file_spec, default_file_spec_len, 
default_file_spec, result_file_spec_len, 
result_file_spec, result_file_ret_len, 
text_file_handle) 


Argument Information 


unsigned long CdaOpenTextFile(file spec_len, file_spec, 

default file _spec_len, default_file_spec, 
result_file_spec_len, result_file spec, 
result _file ret_len, text file handle) 

unsigned long file spec len; 

unsigned char *file spec; 

unsigned long default file spec_len; 

unsigned char *default_file spec; 

unsigned long result file spec len; 

unsigned char *result_file_ spec; 

unsigned long xresult. file: ret: ten; 

unsigned long *text_file handle; 
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RETURNS 


Arguments 


Description 


OPEN TEXT FILE 


status 
A condition value indicating the return status of the routine call. 


file-spec-len 
Length (in bytes) of the string specified by the file-spec argument. 


file-spec 
File specification of the text file to be opened for input. 


default-file-spec-len 
Length (in bytes) of the string specified by dstacieaiedsoe If you specify 0 for 
this parameter, no default file specification is used. 


default-file-spec 

Default file specification. If you specify a 0 for this parameter, no default file 
specification is used. The string should consist only of a file type in lowercase 
characters. On ULTRIX systems, the string is appended to the file specification if 
the file specification does not already contain a period. 


result-file-spec-len 
Length (in bytes) of the buffer specified by result-file-spec. If you specify 0 for 
this parameter, the length of the resultant file specification is not returned. 


result-file-spec 

Receives the resultant file specification. This file specification is the result of a 
VMS RMS $OPEN operation. On ULTRIX systems, the file specification is copied 
to this buffer. If you specify 0 for this parameter, a resultant file specification is 
not returned. 


result-file-ret-len 
Receives the actual length (in bytes) of the resultant file specification. 


text-file-handle 
Receives the handle of the text file. This handle must be used in all subsequent 
operations on that text file. 


The OPEN TEXT FILE routine opens a standard text file for input. 
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RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 


Any error returned by the memory allocation routines. 


Any error returned by the file routines. 
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PRUNE AGGREGATE 


Removes the next sequential document content aggregate from an existing 
in-memory compound document, and returns its handle and type. 


VAX FORMAT 
status = cda$prune_aggregate 
(root-aggregate-handle ,aggregate-handle 
,aggregate-type) 


Argument Information 


Argument Argument Information 
status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
aggregate-type VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
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C FORMAT 


status = CdaPruneAggregate 


(root_aggregate_handle, aggregate_handle, 
aggregate_type) 


Argument Information 


RETURNS 


Arguments 


unsigned long CdaPruneAggregate (root_aggregate_handle, 
aggregate handle, aggregate type) 


unsigned long root_aggregate_ handle; 
unsigned long *aggregate_ handle; 
unsigned long *aggregate type; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the aggregate to be removed. This 
aggregate handle is returned by a call to either the OPEN FILE routine or the 
CREATE ROOT AGGREGATE routine. 


When removing aggregates using the PRUNE AGGREGATE routine, you must 
use the same value for the root aggregate handle argument consistently to remove 
all the aggregates in the compound document. Once you have removed all the 
aggregates, you cannot specify the same root aggregate handle again when calling 
the PRUNE AGGREGATE routine. 


aggregate-handle 
Receives the handle of the removed aggregate. This handle must be used in all 
subsequent operations on that aggregate. 


aggregate-type 
Receives the aggregate type. If the aggregate type returned is DDIF$_EOS (end 
of segment), the value of the aggregate handle argument is 0. 
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Description 


The PRUNE AGGREGATE routine removes the next sequential primary aggre- 
gate from an existing in-memory compound document and returns the aggregate 
identifier and type. Primary aggregates, also known as “top-level” aggregates, 
include all the document content aggregates and the DDIF$_DHD, DDIF$_DSC, 
and DDIF$_EOS aggregates. A front end should invoke this routine from the 
get-aggregate entry point module in cases where the front end builds an entire 
compound document in memory before returning its content. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_ENDOFDOC End of document 
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PRUNE POSITION 


Returns the position in and size of an in-memory document. 


VAX FORMAT 


status = cda$prune_position 
(root-aggregate-handle ,file-position , file-size) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

root-aggregate-handle VMS usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

file-position VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

file-size VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 


status = CdaPrunePosition 
(root_aggregate_handle, file_position, file_size) 
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Argument information 


RETURNS 


Arguments 


Description 


unsigned long CdaPrunePosition(root_aggregate_ handle, 
file position, file_size) 


unsigned long root_aggregate_handle; 
unsigned long *file position; 
unsigned long *file size; 


Status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the in-memory document. The 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. 


file-position 
Receives the current position (in bytes) as measured from the start of the 
document being processed. 


file-size 
Receives the total size (in bytes) of the in-memory document being processed. 


The PRUNE POSITION routine returns the current position in and total size 

of the in-memory document being processed. This routine must be used by the 
get-position routine when a front end builds an entire document in memory before 
returning its content. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
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PUT AGGREGATE 


Writes one or more aggregates to a specified stream. 


VAX FORMAT 


status = cda$put_aggregate 


(root-aggregate-handle ,stream-handle 
,aggregate-handle) 


Argument Information 


Argument 


status 


root-aggregate-handle 


stream-handle 


aggregate-handle 


C FORMAT 


status = CdaPutAggregate 
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Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


(root_aggregate_handle, stream_handle, 
aggregate_handle) 


PUT AGGREGATE 


Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaPutAggregate(root_aggregate_ handle, 
stream_handle, aggregate_handle) 


unsigned long root_aggregate_handle; 
unsigned long stream handle; 
unsigned long aggregate_handle; 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate associated with the aggregate to be written. This 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. 


When writing aggregates using the PUT AGGREGATE routine, you must use the 
same value for root-aggregate-handle consistently to write all the aggregates 
in the compound document. Once you have written all of the aggregates, you 
cannot specify the same root-aggregate-handle again when calling this routine. 


stream-handle 
Identifier of the stream to which the aggregate is to be written. This handle is 
returned by a call to either the CREATE FILE routine or the CREATE STREAM 


routine. 


aggregate-handle 
Identifier of the aggregate to be written. 


The PUT AGGREGATE routine writes one or more aggregates to a specified 
stream. Note that the aggregates remain unchanged after a call to this routine. 
If you do not require these aggregates after you call this routine, your application 
should include a subsequent call to the DELETE AGGREGATE routine to destroy 
these aggregates. 


If the aggregate is part of a sequence, a call to the PUT AGGREGATE routine 
causes the entire sequence to be written. The aggregate type of the written 
aggregate must be one of the following primary DDIF or DTIF aggregates: 
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. Aggregate Type 
DDIF$_DSC 
DDIF$_DHD 
DDIF$_SEG 
DDIF$_TXT 
DDIF$_GTX 
DDIF$_HRD 
DDIF$_SFT 
DDIF$_HRV 
DDIF$_SFV 
DDIF$_BEZ 
DDIF$_LIN 
DDIF$_ARC 
DDIF$_FAS 
DDIF$_IMG 
DDIF$_CRF 
DDIF$_EXT 
DDIF$_PVT 
DDIF$_GLY 
DDIF$_EOS 
DTIF$_HDR 
DTIF$_CLD 
DTIF$_DSC 
DTIF$_TBL 
DTIF$_ROW 


Meaning 

Document descriptor 
Document header 
Document segment 
Text content 
General text content 
Hard directive 

Soft directive 

Hard value directive 
Soft value directive 
Bézier curve content 
Polyline content 
Arc content 

Fill area set content 
Image content 
Content reference 
External content 
Private content 
Layout galley 

End of segment 
Document header 
Cell data 

Document descriptor 
Table definition 


Row definition 


If the aggregate is of type DDIF$_SEG, the segment content must be specified 
by the value of the DDIF$_SEG_CONTENT item. If the segment does not 
contain content, you must use the ENTER SCOPE routine to write the segment 
aggregate. Note that any lower-level content must be attached to the segment 
aggregate before it is written. 


RETURN VALUES 


Return Value 
CDA$_NORMAL 
CDA$_INVAGGTYP 
CDA$_INVDOC 


Description 
Normal successful completion 
Invalid aggregate type 


Invalid document content 


Any error returned by the file routines. 
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PUT DOCUMENT 


Writes an entire document to the specified stream. The document is not changed 


by this operation. 


VAX FORMAT 


status = cda$put_document 
(root-aggregate-handle ,stream-handle) 


Argument Information 


C FORMAT 


Argument 


status 


root-aggregate-handle 


stream-handle 


status = CdaPutDocument 
(root_aggregate_handle, stream_handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


CDA Toolkit Routines 8-153 


PUT DOCUMENT 


Argument Information 


unsigned long CdaPutDocument (root_aggregate_handle, 
stream_handle) 
unsigned long root_aggregate_handle; 
unsigned long stream_handle; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 


Arguments 


root-aggregate-handle 

Identifier of the root aggregate associated with the document to be written. This 
handle is returned by a call to either the OPEN FILE routine or the CREATE 
ROOT AGGREGATE routine. 


Once you write an entire document, you cannot call the PUT DOCUMENT 
routine specifying the same root aggregate handle again. That is, you can only 
write a document associated with a particular root aggregate once. 


stream-handle 
Identifier of the stream to which the document is to be written. This handle is 
returned by a call to either the CREATE FILE routine or the CREATE STREAM 


routine. 





Description 
The PUT DOCUMENT routine writes an entire document to a specified stream. 
Note that the document remains unchanged after a call to this routine. If you do 
not require the in-memory structure after you call this routine, your application 
should include a subsequent call to the DELETE ROOT AGGREGATE routine to 
destroy this structure. 
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RETURN VALUES 





Return Value _ Description 
CDA$_NORMAL Normal successful completion 
CDA$_INVDOC Invalid document content 


Any error returned by the file routines. 
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READ TEXT FILE 


Reads a line from a standard text file. 


VAX FORMAT 


status = cda$read_text_file 
(text-file-handle ,buffer-length ,buffer-address) 


Argument Information 


Argument Argument Information 

status VMS usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

text-file-handle VMS usage: identifier 
Data type: | longword (unsigned) 
Access: read only 
Mechanism: by reference 

_ buffer-length VMS usage: longword_unsigned 

Data type: longword (unsigned) 
Access: write only 
Mechanism: ‘by reference 

buffer-address VMS usage: address 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


C FORMAT 


status = CdaReadTextFile 
(text_file_handle, buffer_length, buffer_address) 
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Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaReadTextFile(text_file handle, 
buffer_length, buffer_address) 


unsigned long text_file handle; 
unsigned long *buffer length; 
unsigned char *buffer address; 


status 
A condition value indicating the return status of the routine call. 


text-file-handle 
Identifier of the text file from which the line is to be read. This handle is returned 
by a call to the OPEN TEXT FILE routine. 


buffer-length 
Receives the length (in bytes) of the line that is read. 


buffer-address 

Receives the address of the line that is read. No trailing record delimiter is 
present. On ULTRIX, buffer-address receives the address of the line up to, but 
not including, the new-line indicator. 


The READ TEXT FILE routine reads a line from a standard text file. On VMS 
systems, the line is the next RMS record in the file. On ULTRIX systems, the line 
is delimited by a new-line character. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_ENDOFDOC End of document 


Any error returned by the file routines. 
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REMOVE AGGREGATE 


Removes an aggregate from a sequence. The aggregate is not deleted. If the 
specified aggregate is not part of a sequence and has no parent aggregate, no 


operation is performed. 


VAX FORMAT 


status = cda$remove_aggregate 


Argument Information 


Argument 


status 


aggregate-handle 


C FORMAT 


(aggregate-handle) 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


status = CdaRemoveAggregate 


Argument Information 


(aggregate_handle) 


unsigned long CdaRemoveAggregate (aggregate handle) 
aggregate_handle; 


unsigned long 
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RETURNS 


Arguments 


Description 


REMOVE AGGREGATE 


Status 
A condition value indicating the return status of the routine call. 


aggregate-handle 
Identifier of the aggregate to be removed from the sequence. 


The REMOVE AGGREGATE routine removes an aggregate that is part of a 
sequence from that sequence. The aggregate is not deleted. If the aggregate is 
not part of a sequence and has no parent aggregate, no action is performed. 


NOTE 


Do not attempt to use the REMOVE AGGREGATE routine to remove 
the only aggregate from a single-aggregate sequence, or to remove an 
aggregate from its parent when the corresponding aggregate-valued 
item of the parent is not defined to be a sequence of aggregates. 


Although current implementation of the REMOVE AGGREGATE 
routine allows removing the only aggregate from a single-aggregate 
sequence, and even allows removing an aggregate from its parent when 
the corresponding aggregate-valued item of the parent is not defined 
to be a sequence of aggregates, the use of the REMOVE AGGREGATE 
routine in this manner is not supported and may leave the aggregate 
data structures in an inconsistent state. This use of the REMOVE 
AGGREGATE routine may be prevented (causing an error status to be 
returned) in a future release of the CDA toolkit. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 
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STORE ITEM 


Writes the contents of an item within an aggregate. If the item is indexed, the 


index must not exceed one more than the number of existing items. 


VAX FORMAT 


status = cda$store_item 
(root-aggregate-handle ,aggregate-handle 
,aggregate-item ,buf-len ,buf-adr [,aggregate-index] 
[,add-info]) 


Argument Information 


Argument 


status 


root-aggregate-handle 


aggregate-handle 


aggregate-item 
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Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


C FORMAT 


Argument 


buf-len 


buf-adr 


aggregate-index 


add-info 


status = CdaStoreltem 


(root_aggregate_handle, aggregate_handle, 
aggregate_item, buf_len, buf_adr, aggregate_index, 


add_info) 


Argument Information 


STORE ITEM 


Argument Information 


VMS usage: 
Data type: 
Access: 


Mechanism: 
VMS usage: 


Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 
Access: 


Mechanism: 


VMS usage: 
Data type: 
Access: 


Mechanism: 


longword_unsigned 
longword (unsigned) 
read only 


by reference 
vector_byte_unsigned 


byte (unsigned) 
read only 


by reference, array reference 


longword_unsigned 
longword (unsigned) 
read only 


by reference 


longword_unsigned 
longword (unsigned) 
read only 

by reference 


unsigned long CdaStoreItem(root_aggregate_handle, 
aggregate handle, aggregate_item, 
buf_len, buf_adr, aggregate_index, 


add_info) 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


long 
long 
long 
long 
char 
long 
long 


root_aggregate_handle; 
aggregate_handle; 
aggregate item; 


buf_len; 
*buf_adr; 


aggregate_index; 


add_info; 
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RETURNS 


Arguments 


status 
A condition value indicating the return status of the routine call. 


root-aggregate-handle 

Identifier of the root aggregate with which the aggregate containing the item is 
associated. This handle is returned by a call to either the OPEN FILE routine or 
the CREATE ROOT AGGREGATE routine. 


You must use identical memory management procedures when storing and 
locating an item within an aggregate to ensure consistent treatment of memory 
allocation and deallocation. 


aggregate-handle 
Identifier of the aggregate into which the item is written. 


aggregate-item 

Identifying code of the item, expressed as a symbolic constant. The DDIF 
aggregate item symbolic constants are defined in the file ddif$def.h on VMS 
systems and in the file ddif_def.h on ULTRIX systems and are described in 
Chapter 4. The DTIF aggregate type symbolic codes are defined in the file 
dtif$def.h on VMS systems and in the file dtif_def.h on ULTRIX systems and are 
described in Chapter 5. 


A user context item named DDIF$ USER_CONTEXT for DDIF aggregates 
and DTIF$_USER_CONTEXT for DTIF aggregates is available within every 
aggregate. This item is a longword that can be used by the application for any 
purpose. 


buf-len 
Length (in bytes) of the buffer specified by the buf-adr argument. 


buf-adr 
Buffer containing the item’s value. 


aggregate-index 

Index of the item (relative to 0). This argument is required whenever the notation 
“Array of’ appears in the data type of the specified item handle. Otherwise, this 
argument is only required if the add-info argument is also required. 


add-info 

Data type-specific modifier for the data types character string, string with 
add-info, general floating-point, and scaled integer. For data types other than 
character string, string with add-info, general floating-point, and scaled integer, 
this argument is ignored and may be omitted. 
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Description 


STORE ITEM 


For the data type character string, the add-info parameter contains the char- 
acter set designator. For the data type scaled integer, the add-info parameter 
receives an integer scaling factor. For the data type string with add-info, if the 
string value is equal to one of the standard tag values, the add-info parameter 
contains a value that identifies the tag. For the data type general floating- 
point, the add-info parameter contains a value that identifies the format of the 
floating-point value supplied in buf-adr. For add-info values for the general 
floating-point type, see Table 1-1. Otherwise, add-info contains a value that 
indicates that the tag is private. 


The STORE ITEM routine lets you store the value of each item within an 
ageregate. After creating an aggregate, you must use this routine to fill in the 
appropriate items in the aggregate. The items that exist for each aggregate are 
defined in the files ddif$def.h and dtif$def.h on VMS systems and in the files 
ddif_def.h and dtif_def.h on ULTRIX systems, and are described in Chapter 4 and 
in Chapters 5 through 7. Note that there are optional and required aggregate 
items. If the text does not specify that the item is optional, then it must be 
specified in order to create a valid aggregate of that type. 


If an aggregate item is indexed, the index specified must not exceed one more 
than the maximum index of the previously stored indexed items. If the item is of 
data type variable, the value of the item that determines the data type must have 
been previously established. 


The STORE ITEM routine erases the previous item value, unless the item is 
“aggregate valued” and not empty. (An “aggregate-valued” item is one in which 
the value of the aggregate is actually the handle of another aggregate.) In the 
case of an item that is aggregate valued and not empty, the specified aggregate 
is inserted in sequence before the existing aggregate. If the specified aggregate 
is the beginning of a sequence, the entire sequence is inserted before the existing 
aggregate. If the specified aggregate is part of a sequence but is not the first 
aggregate in the sequence, or if the specified aggregate is the value of an item, an 
error is returned. 


RETURN VALUES 


Return Value Description 

CDA$ NORMAL Normal successful completion. 
CDA$_INVAGGTYP Invalid aggregate type. 
CDA$_INVITMCOD Invalid item code. 
CDA$_INDEX Index exceeds array bounds. 
CDA$_VAREMPTY Variant item is empty. 
CDA$_VARINDEX Variant index exceeds bounds. 
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Return Value Description 

CDA$_VARVALUE Variant value is undefined. 
CDA$_INVINSERT Aggregate already in a sequence. 
CDA$_INVBUFLEN Invalid buffer length. 


Examples 


This example illustrates the creation of a document descriptor aggregate (type 
DDIF$_DSC), and the use of the STORE ITEM routine to fill in the items in the 


aggregate. 


static unsigned char 
product_name[] = {"Sample Product"}; 


aggregate type = DDIFS$_DSC; 

status = cda$create_aggregate(&root_aggregate_handle, 
éaggregate type, 
g&aggregate_ handle); 

if (FAILURE (status)) return(status); 


aggregate_item = DDIF$_DDF_DESCRIPTOR; 
local_length = sizeof (aggregate handle) ; 
status = cda$store item(&root_aggregate_handle, 
&root_aggregate_handle, 
&aggregate item, 
&local_length, é&aggregate_handle) ; 
if (FAILURE (status)) return(status) ; 


aggregate _ item = DDIF$_DSC_MAJOR_VERSION; 

local _ length = sizeof (integer value) ; 

integer value = 1; 

status = cda$store_item(&root_aggregate_handle, 
g&aggregate_handle, 
&aggregate item, &local_ length, 
&integer value); 

if (FAILURE (status)) return(status); 


aggregate _item = DDIF$ DSC_MINOR_VERSION; 

local_length = sizeof (integer value); 

integer value = 0; 

status = cda$store item(&root_aggregate_ handle, 
&aggregate_handle, 
&aggregate_ item, &local_ length, 
&integer value); 

if (FAILURE(status)) return(status); 
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aggregate item = DDIF$_DSC_PRODUCT_IDENTIFIER; 

local_length = 7; 

status = cda$store_item(&root_aggregate_handle, 
g&aggregate handle, 
&aggregate item, &local_length, 
"Example") ; 

if (FAILURE (status)) return(status); 


aggregate_item = DDIF$_DSC_PRODUCT_NAME; 

local_len = sizeof (product_name) ; 

aggregate_index = 0; 

add_info = CDA$K_ISO LATIN1; 

status = cda$store _item(&root_aggregate_handle, &aggregate_handle 
&aggregate_item, &local_length, 
product_name, &aggregate_index, 
&add_info); 

if (FAILURE (status)) return(status); 


This example illustrates the use of the STORE ITEM routine to specify two 
transformation aggregates (type DDIF$_TRN). The type of transformation 
specified by the DDIF$_TRN aggregate is indicated by the value of the DDIF$_ 
TRN_PARAMETER _C item. The first transformation aggregate specifies an 
x-scale transformation. The second transformation aggregate specifies a 2 x 3 
matrix transformation of the following format: 


ADOBEOCFi1 


Each matrix coefficient is stored in the DDIF$_TRN aggregate in each call to the 

STORE ITEM routine. The first call to STORE ITEM for this matrix writes the A 
matrix coefficient into array item 0; the second call writes B to array item 1, and 
so on until coefficients A through F are written to the array. You are responsible 

for updating the aggregate index of the array each time a coefficient is written. 


One matrix coefficient is stored in each call to the STORE ITEM routine. The 
aggregate index is used to specify which matrix coefficient is being written. 


aggregate _type = DDIF$ _TRN; 

status = cda$create_aggregate(&root_aggregate_handle, 
é&aggregate type, 
&inner_aggregate_ handle); 

if (FAILURE(status)) return(status); 


aggregate _item = DDIF$ SGA_FRM_TRANSFORM; 

item_length = 4; 

status = cda$store_item(&root_aggregate_handle, 
&aggregate handle, é&aggregate_item, 
&item_length, 
&inner aggregate_handle) ; 

if (FAILURE (status)) return(status); 


CDA Toolkit Routines 8-165 


STORE ITEM 


aggregate _ item = DDIF$ TRN_ PARAMETER C; 
local _ length = sizeof (integer value); 
integer value = DDIFS$K_X_SCALE; 
status = cda$store item(&root_aggregate_ handle, 
&inner aggregate_handle, 
é&aggregate item, 
é&local_ length, é&integer value); 
if (FAILURE (status)) return(status); 


aggregate item = DDIF$ TRN PARAMETER; 

local length = sizeof (float_value); 

float_value = 3.5; 

status = cda$store item(&root_aggregate_ handle, 
é&inner_aggregate_handle, 
&aggregate_ item, 
&local_ length, &float_value); 

if (FAILURE (status)) return(status) ; 


aggregate type = DDIF$_TRN; 
status = cda$create aggregate (&root_aggregate_handle, 
é&aggregate type, 
&inner aggregate handle 2); 
if (FAILURE (status)) return(status) ; 


status = cda$insert_aggregate(&inner_ aggregate handle 2, 
&inner_ aggregate handle); 
if (FAILURE (status)) return(status); 


aggregate _item = DDIF$_TRN PARAMETER _C; 
local length = sizeof (integer value) ; 
integer _value = DDIF$K_MATRIX_2 BY_3; 
status = cda$store item(&root_aggregate_handle, 
&inner aggregate handle 2, 
é&aggregate_item, 
&local_ length, &integer_value) ; 
if (FAILURE (status)) return(status) ; 


aggregate _item = DDIF$_TRN_PARAMETER; 

local_length = sizeof (float_value); 

float_value = 4.75; 

aggregate index = 0; 

status = cda$store_item(é&root_aggregate handle, 
&inner_aggregate_ handle 2, 
&aggregate item, 
&local_length, &float_value, 
&aggregate_index) ; 

if (FAILURE(status)) return(status) ; 


aggregate item = DDIF$ TRN PARAMETER; 

local_length = sizeof (float_value); 

float _value = 6.11; 

aggregate index = 1; 

status = cda$store_ item(&root_aggregate_ handle, 
&inner aggregate handle 2, 
&aggregate_ item, 
&local_length, &float_value, 
&aggregate_ index) ; 

if (FAILURE(status)) return(status); 
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aggregate item = DDIF$_TRN_ PARAMETER; 

local_length = sizeof (float_value); 

float. value = 2,22; 

aggregate index = 2; 

status = cda$store item(&root_aggregate_handle, 
&inner aggregate handle 2, 
saggregate item, 
&local_length, &float_value, 
&aggregate_ index) ; 

if (FAILURE (status)) return(status); 


aggregate_item = DDIFS_ TRN_PARAMETER; 

local_length = sizeof (float_value) ; 

float_value = 3.0; 

aggregate index = 3; 

status = cda$store_item(&root_aggregate_handle, 
&inner _aggregate_handle 2, 
&aggregate item, 
&local_length, &float_value, 
&aggregate_ index) ; 

if (FAILURE (status)) return(status); 


aggregate _item = DDIFS$_TRN_ PARAMETER; 

local_length = sizeof(float_value); 

float. value = 1.25; 

aggregate _index = 4; 

status = cda$store_item(&root_aggregate_handle, 
&inner aggregate handle 2, 
&aggregate item, 
&local_length, &float_value, 
&aggregate_index); 

if (FAILURE (status)) return(status); 


aggregate item = DDIF$ TRN PARAMETER; 

local_length = sizeof(float_value) ; 

float_value = 2.15; 

aggregate_index = 5; 

status = cdaSstore item(é&root_aggregate handle, 
&inner_aggregate_handle 2, 
é&aggregate item, 
&local_length, &float_value, 
é&aggregate_ index); 

if (FAILURE (status)) return(status); 
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WRITE TEXT FILE 


Writes a line of text to a standard text file. 


VAX FORMAT 


status = cda$write_text_file 
(text-file-handle ,buffer-length ,buffer-address) 


Argument Information 


Argument 


status 


text-file-handle 


buffer-length 


buffer-address 


C FORMAT 


Argument Information 

VMS usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

VMS usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

VMS usage: char_string 

Data type: character string 
Access: read only 
Mechanism: by reference 


status = CdaWriteTextFile 
(text_file_handle, buffer_length, buffer_address) 
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Argument Information 


RETURNS 


Arguments 


Description 


unsigned long CdaWriteTextFile(text_file_handle, 
buffer length, buffer_address) 


unsigned long text_file handle; 
unsigned long buffer length; 
unsigned char *buffer address; 


Status 
A condition value indicating the return status of the routine call. 


text-file-handle 
Identifier of the text file to which the line is written. This handle is returned by 
a call to the CREATE TEXT FILE routine. 


buffer-length 
Length (in bytes) of the buffer specified by the buffer-address argument. 


buffer-address 
The line to be written to the text file. 


The WRITE TEXT FILE routine writes a line of text to a standard text file. On 
VMS systems, the written line becomes an RMS record. On ULTRIX systems, the 
written line is followed by a new-line character. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 


Any error returned by the file routines. 
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Chapter 9 


User-Defined Routines 


The chapter describes the user-defined routines used to write both CDA- 
conforming applications and front and back ends. You can supply these routines 
to modify the operation of the CDA Toolkit routines. For example, the GET 
AGGREGATE routine, by default, calls a CDA Toolkit get routine. However, you 
may provide your own get routine using the format described in this chapter. 


Each routine description includes the following information: 


e A routine definition that each application must name according to its 
operating system-specific format 


¢ Descriptions of each routine argument 
¢ A description of the routine itself 


e A list of possible values returned by each routine argument 


NOTE 


The entry points and conventions defined throughout this reference 
section must be followed on both VMS and ULTRIX systems in order 
for all front and back ends to work properly with the CDA Converter 
Kernel. 


If you are programming in Ada, please refer to the Guide to Applications 
Programming for information on Ada programming with DECwindows. 
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Allocate/Deallocate Routines 


Allocate/Deallocate Routines 


Are the specification of the calling standard for two optional user-supplied rou- 
tines used to perform memory allocation and deallocation. The address of these 
routines can be passed to the CREATE FILE, CREATE ROOT AGGREGATE, 
CREATE STREAM, OPEN STREAM, or OPEN FILE routine. If specified, these 
allocation and deallocation routines will be used throughout the CDA Toolkit to 


allocate and deallocate memory. 


FORMAT 


status = user-rtn§ (num-bytes ,base-adr ,alloc-dealloc-prm) 


Argument Information 


Argument 


status 


num-bytes 


base-adr 


alloc-dealloc-prm 


RETURNS 


Status 


Argument Information 

Usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

Usage: address 

Data type: longword (unsigned) 
Access: read only or write only 
Mechanism: by reference 

Usage: user_arg 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 


A condition value indicating the return status of the routine call. 
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Arguments 


Description 


Allocate/Deallocate Routines 


num-bytes 
The number of bytes to allocate or deallocate. The value of num-bytes must be 
greater than zero. 


base-adr 

Virtual address of the first byte of memory to be allocated or deallocated. (This 
argument is write-only for an allocate routine, and read-only for a deallocate 
routine. ) 


alloc-dealloc-prm 
User context argument. 


The allocate /deallocate routines are the specification of the calling standard 

for two optional user-supplied routines used to perform memory allocation and 
deallocation. The address of these routines can be passed to the CREATE FILE, 
CREATE ROOT AGGREGATE, CREATE STREAM, OPEN STREAM, or OPEN 
FILE routine. If specified, these allocation and deallocation routines will be used 
throughout the CDA Toolkit to allocate and deallocate memory. 


The alloc-dealloc-prm argument is passed through these CDA routines to 
the user-supplied routine. For example, the alloc-dealloc-prm argument 
must be supplied to the CREATE FILE routine, which will then pass it to the 
user-supplied allocate routine. 


RETURN VALUES 


Each of these user routines must return a completion status. The VMS conven- 
tion for completion codes is followed. If the low bit of the return value is clear, an 
error has occurred and the caller returns control to its caller; if the low bit of the 
return value is set, the caller continues execution. 
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Flush Routine 


Is a specification of the calling standard for an optional user-supplied routine. 
The address of a routine that meets this specification can be passed to the 
FLUSH STREAM routine, which will use the routine to force the writing of the 


user’s buffer. 


FORMAT 
status = flush-rtn = (flush-prm) 


Argument Information 


Argument Argument Information 

status Usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

flush-prm Usage: user_arg 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 


RETURNS 
status 


A condition value indicating the return status of the routine call. 


Arguments 


flush-prm 
User context argument. 
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Description 


Flush Routine 


The flush routine is a specification of the calling standard for an optional user- 
supplied routine. The address of a routine that meets this specification can be 
passed to the FLUSH STREAM routine, which will use the routine to force the 
writing of the user’s buffer. 


The user-supplied flush routine is only neccessary when a user-supplied put 
routine (using buffered output) has been specified in the call to the CREATE 
STREAM routine. 


RETURN VALUES 


The user-defined flush routine must return a value that is one of the error status 
codes named by the CDA Toolkit (such as CDA$_INVDOC), by VMS RMS, or that 
is application-defined. 


If the first bit of the longword returned by this routine is set to 1, the return 
status is successful. However, if the first bit of the longword returned by this 
routine is set to 0, the return status is unsuccessful. 


This routine must return a completion status. The VMS convention for comple- 
tion codes is followed. If the low bit of the return value is clear, an error has 
occurred and the caller returns control to its caller; if the low bit of the return 
value is set, the caller continues execution. 
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Get Routine 


FORMAT 


Argument Information 


RETURNS 


Is a specification of the calling standard for an optional user-supplied routine. 
The address of a routine that meets this specification can be passed to the 


CONVERT routine or to the OPEN STREAM routine. 


status = get-rtn (get-prm ,num-bytes ,buf-adr) 


Argument 


status 


get-prm 


num-bytes 


buf-adr 


status 


Argument Information 


Usage: 
Data type: 
Access: 


Mechanism: 


Usage: 
Data type: 


Access: 


Mechanism: 


Usage: 
Data type: 


Access: 


Mechanism: 


Usage: 
Data type: 
Access: 


Mechanism: 


cond_value 
longword (unsigned) 
write only 


by value 


user_arg 
longword (unsigned) 
read only 


by value 


longword_unsigned 
longword (unsigned) 
write only 


by reference 


address 
longword (unsigned) 
write only 


by reference 


A condition value indicating the return status of the routine call. 
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Arguments 


Description 


Get Routine 


get-prm 
User context argument. 


num-bytes 

Receives the number of bytes contained in the buffer. The num-bytes argument 
is the address of an unsigned longword that receives this number. The number of 
bytes is zero only if the stream does not contain any more data. 


buf-adr 
Receives the address of an unsigned longword that receives the buffer address. 


The get routine is a specification of the calling standard for an optional user- 
supplied routine. The address of a routine that meets this specification can be 
passed to the CONVERT routine or to the OPEN STREAM routine. 


For the CONVERT routine, this address will be passed to a front end converter, 
which may then use the specified routine to read input data. Refer to the example 
for the CONVERT routine in Chapter 8. 


For the OPEN STREAM routine, this address will be stored for use by the GET 
AGGREGATE routine when reading input data. 


RETURN VALUES 


Return Value Description 
CDA$_NORMAL Normal successful completion 
CDA$_ENDOFDOC End of document 
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Get-Position Routine 


Is a specification of the calling standard for an optional user-supplied routine. 
The address of a routine that meets this specification can be passed to the 
CONVERT routine. This user-supplied routine must provide position information 
to allow the application reader or converter to determine the total size of the 
current input stream as well as to determine the current position within the 
stream. (This routine is useful for viewer back ends that provide a scroll bar 
indicating the current position in the document being viewed.) 


FORMAT 


status = get-pos-rtn (siream-prm ,stream-size) 


Argument Information 


Argument 


status 


stream-prm 


stream-size 


RETURNS 


status 


Argument Information 

Usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

Usage: user_arg 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 

Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


A condition value indicating the return status of the routine call. 
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Arguments 


Description 


Get-Position Routine 


stream-prm 
User context argument. 


stream-size 

Receives the number of bytes contained in the buffer. The stream-size argument 
is the address of an unsigned longword that receives this number. The number of 
bytes is zero only if the stream does not contain any more data. 


The get-position routine is a specification of the calling standard for an optional 
user-supplied routine. The address of a routine that meets this specification can 
be passed to the CONVERT routine. This user-supplied routine must provide 
position information to allow the application reader or converter to determine the 
total size of the current input stream as well as to determine the current position 
within the stream. (This routine is useful for viewer back ends that provide a 
scroll bar indicating the current position in the document being viewed.) 


RETURN VALUES 


The user-defined get-position routine can return a value that is one of the error 
status codes named by the CDA Toolkit (such as CDA$_INVDOC), by VMS RMS, 
or one that is application-defined. 


If the first bit (bit 0) of the longword returned by this routine is set to 1, the 
return status is successful. However, if the first bit of the longword returned by 
this routine is set to 0, the return status is unsuccessful. 
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Put Routine 


Is a specification of the calling standard for an optional user-supplied routine. 
The address of a routine that meets this specification can be passed to the 
CONVERT routine or to the CREATE STREAM routine. 


FORMAT 


status = put-rtn = (pout-prm ,num-bytes ,buf-adr ,next-buf-len 


Argument Information 


Argument 


status 


put-prm 


num-bytes 


buf-adr 


next-buf-len 
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,next-buf-adr) 


Argument Information 

Usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

Usage: user_arg 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by value 

Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

Usage: vector_byte_unsigned 
Data type: byte (unsigned) 
Access: read only 
Mechanism: by reference, array reference 
Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


RETURNS 


Arguments 


Description 


Put Routine 


Argument Argument Information 

next-buf-adr Usage: address 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

Status 


A condition value indicating the return status of the routine call. 


put-prm 
User context argument. 


num-bytes 
Number of bytes contained in the buffer. The num-bytes argument is the 
address of an unsigned longword that contains this value. 


buf-adr 
Address of the buffer. The buf-adr argument is the address of an array of 
unsigned bytes. 


next-buf-len 
Length of the buffer specified by next-buf-adr. The next-buf-len argument is 
the address of an unsigned longword that receives this length. — 


next-buf-adr 

Address of a buffer that will receive further output data. The next-buf-adr 
argument is the address of an unsigned longword that receives this address. 
Next-buf-adr may simply be the current buffer, or a different buffer. 


The put routine is a specification of the calling standard for an optional user- 
supplied routine. The address of a routine that meets this specification can be 
passed to the CONVERT routine or to the CREATE STREAM routine. 


For the CONVERT routine, this address will be passed to a back end converter, 
which may then use the specified routine to write output data. Refer to the 
example for the CONVERT routine in Chapter 8. 


For the CREATE STREAM routine, this address will be stored for use by the 
PUT AGGREGATE routine when writing output data. 
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Put Routine 


RETURN VALUES 


Return Value | Description 
CDA$_NORMAL Normal successful completion 


The user-defined put routine always returns a status CDA$_NORMAL in an 
unsigned longword integer. 


The user-defined put routine can also return a value that is one of the error 
status codes named by the CDA Toolkit (such as CDA$_INVDOC) or that is 
application-defined. 


If the first bit of the longword returned by this routine is set to 1, the return 
status is successful. However, if the first bit of the longword returned by this 
routine is set to 0, the return status is unsuccessful. 


9-12 User-Defined Routines 


Chapter 10 


CDA Toolkit Example Program 





This chapter illustrates a sample program, written in VAX C, that uses the 
CDA Toolkit to create a DDIF document. Example 10-1 contains comments 
where necessary, and Example 10-2 illustrates the analysis output of the DDIF 
document created by the program. The callouts in this example correspond to 
the callouts in Example 10-2. For example, if a callout corresponds to a call 

to the CREATE ROOT AGGREGATE routine in Example 10-1, the callout in 
Example 10-2 identifies the beginning of the document root aggregate created by 


that call. 


Example 10-1: Sample CDA Toolkit Program 


#ifdef vms 

#include <ddifSdef.h> /* Include DDIF keyword definitions. */ 
#include <cdaS$def.h> /* Include CDA Toolkit keyword definitions. */ 
#else 

#include <ddif_def.h> /* Include DDIF keyword definitions. x), 
#include <cda_def.h> /* Include CDA Toolkit keyword definitions. */ 
#endif 


#define FAILURE (x) 
#define MAX POINTS 4 


/* 
** Subroutines to generate frequently-used aggregates. 
xf 

extern unsigned long create hrd _dir( ); 


extern unsigned long create _gtx( ); 
unsigned long poly points[MAX POINTS] [2] = 


CU) 6 De 5-0) 


{ 
{ 500, 


500 }, 
{ 2500, 2000 }, 
{ 3500, 2000 }, 
{ 5500, 500 } 
}; 
unsigned long aggregate_ type; 
unsigned long aggregate item; 
unsigned long aggregate _ index; 
unsigned long add_info; 
unsigned long file handle; 
unsigned long integer value; 
unsigned long integer length = sizeof( integer value ); 
unsigned long local length; 
unsigned long status; 
unsigned long stream_handle; 
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unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


long 
long 
long 
long 
long 
long 


_ aggregate handle length = 


aggregate handle; 

sizeof( aggregate_handle ); 
root_aggregate_ handle; 

previous aggregate handle; 

aggregate handle stack[ 100 ]; 

ahs_index = 0; 


/* Data and structures for the frame definition. */ 


struct frm_flags 


unsigned 
unsigned 


long 
long 


sga_frame_flags; 


= 6000; 
= 2400; 


frame_ur_x value 
frame_ur_y value 


/* Data for the polyline and Bezier curve. */ 


unsigned 


long 


i; 


/* Data for the arc. */ 


struct arc_flags set_arc_ flags; 


float 
float 


unsigned 


unsigned 


unsigned 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 
unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 


unsigned 
unsigned 


arc_start = 
arc_extent = 


long 
long 


long 


char 
long 
char 
long 
long 


long 
long 


long 
long 


char 
long 


char 
long 
char 
long 


char 
long 


char 
long 


char 
long 


char 
long 


4.5e1; 
9.0e1; 


arc_line width = 60; 


erf data_type[] = 
{i73,12;1011,1 73,1)? 


erf data_type length = sizeof (erf data_type); 


filename[] = "DDIF_EXAMPLE.DDIF"; 
filename_length = sizeof( filename ) 
result file spec (Z255]'; 
result _file spec_len = 
result file ret ten; 


sizeof( result_file_spec ); 


dsc_major version = 1; 
dsc_major_version_length 


Hi 


sizeof( dsc_major_version ); 


dsc_minor version = 0; 
dsc_minor_version_length 


sizeof( dsc_minor version ); 


dsc_product_identifier[] = "DDIFS$"; 
dsc_product_identifier_length = 
sizeof( dsc_product_identifier ) - 1; 


dsc_product_name[] = "Test V1.0"; 
dsc_product_name_length = sizeof( dsc_product_name ) - 1; 
erf descriptor _name[] = "Style Guide"; 


erf descriptor _name_length = sizeof( erf_descriptor name ) - 1; 
erf label name[] = "defstyle"; 
erf_label_name_length = sizeof( erf_label_name ) - 1; 
exrf_label _type[] = "S$STYLE"; | 
erf_label_type length = sizeof( erf_label_type ) - 1; 
dhd_languages_1[] = "E/USA/"; 
dhd_languages_length_1 = sizeof( dhd_languages_1 ) - 1; 


"Mandarin"; 
sizeof( dhd_languages 2 ) - 1; 


dhd_languages_2[] = 
dhd_languages_length 2 = 
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unsigned char 
unsigned long 


unsigned char 
unsigned long 


unsigned char 
and should be 


unsigned char 


sga_content_category[] = "$2D"; 
sga_content_category length 2 = 
sizeof( sga_content_category ) - 1; 
txt_content[] = "This is the first line of the example text."; 
txt_content_length = sizeof( txt_content ) - 1; 
gtx_content_1[] = "This is the second line of the example text, \ 


separated from the first line by a single space."; 


gtx_content_2[] = "The third line of the example text will \ 


begin on a new line."; 


unsigned char 


gtx_content_3[] = "The fourth line of the example text will be \ 


separated from the previous lines by a blank line, and will be the \ 
last text on the first page."; 


unsigned char 
unsigned long 


unsigned char 
unsigned long 


unsigned char 
unsigned long 


unsigned char 
unsigned long 


unsigned char 
unsigned long 


main () 


{ 


para_seg _type[] "PARA"; 
para_seg type length = sizeof( para_seg_ type ) - 1; 


tyd_label[}] = "FRAME"; 
tyd_label length = 
sizeof( tyd_label ) - 1; 


pline_ label[] = "pline"; 
pline label length = 
sizeof( pline label ) - 1; 


bline label{] = "bline"; 
bline label length = 

sizeof( bline label ) - 1; 
filled_arc_labelf[] = "filled_arc"; 
filled_arc label length = 

Sizeoi(. filled arc: label «> 17 


printf ("Creating in-memory DDIF structure...\n" ); 
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/* 


KRREKKKE KKK KKK KR K KKK KKK KK KKK KK KEK KEK KIRK KKK KKK KKK KKK KEKE KKK KEKE KKK KKK KKKKKKKKKKKKKKEK 


KK 
kk 
kx* 
kk 
** 
Kk 
kk 
*k* 
*x* 
*K* 
xk 
Kk 
xk 
x* 
a* 
xk 
Kk 
Kk 
** 
x* 
** 


The overall structure (excluding hard directives) is as follows: 


DDF 
(Root Aggregate) 


/ | ‘ 
DSC DHD SEG 
(Descriptor) (Header) (Segment) 


| 
SEG 


| 
TXT - GTX - SEG - GTX - SEG - GTX - SEG - GTX 


| | | 
LIN BEZ SEG 


KEREKKKKKKEKKEKKRKEKKEKKKEKKKRKEKEKREKERKEKKRKKRKRKKKERKEEKEKREREKREKEKKRRERKERKEKEKKEKRKKRKRKEKKERKERER 


xf 


/* 


/* 

** Create the DDIF Root Aggregate. 

A 

aggregate type = DDIF$ DDF; 

status = cda$create_root_aggregate( 0, 0, 0, 0, 1) 
é&aggregate type, 
&root_aggregate handle ); 


if( FAILURE( status ) ) 
return ( status ); 


KKKEKKEK KKK KKK KKK KKK KKK KR KKK KEKE KK KKK KK KKK KKK KKK KK KK KKK KKK KKK KKK KK KEK KK KK KKK KKK 


Kk 
xk 
xk 
K*K 
*kx* 
k* 
*x* 


DESCRIPTOR: 


1) create the Descriptor aggregate 
2) attach it to the Root aggregate 
3) fill in the items in the Descriptor aggregate. 


KKKKKKKK KK KKK KKK KKK KKK KKK RK KK EK KEK KK KKK KEK EK KEK KKK KKK KKK KKK KE KKK KKKKKRKKKKEKKEKKK 


al d 


/* 
** Create the Descriptor aggregate and attach it to the Root aggregate 
** by storing its handle in the Descriptor item of the Root aggregate. 
ay 
aggregate type = DDIF$ DSC; 
status = cda$create_aggregate( &root_aggregate_handle, e 
&aggregate type, 
saggregate handle stack[ahs_index] ); 


if( FAILURE( status ) ) 
return ( status ); 
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aggregate_item = DDIF$ DDF_DESCRIPTOR; 

status = cda$store_item( &root_aggregate_handle, © 
é&root_aggregate_handle, 
é&aggregate_ item, 
é&aggregate handle length, 
é&aggregate_ handle _stack[ahs_ index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 

**x Fill in the Major Version item of the Descriptor aggregate. 

wy 

aggregate_item = DDIF$_DSC_MAJOR_VERSION; 

status = cda$store_item( &root_aggregate_handle, 4] 
é&aggregate handle stack[ahs_index], 
éaggregate_item, 
&dsc_major version length, 
&dsc_major_version ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
**x Fill in the Minor Version item of the Descriptor aggregate. 


uf 


aggregate_item = DDIF$ DSC_MINOR_VERSION; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
é&aggregate item, 
é&dsc_minor_version_length, 
&dsc_minor_ version ); 

if( FAILURE( status ) ) 

return (. status ); 


/* 
**x Fill in the Product Identifier item of the Descriptor aggregate. 
tj 


aggregate_item = DDIF$_DSC_PRODUCT_IDENTIFIER; 

status = cda$store_item( &root_aggregate_handle, 
é&aggregate handle stack[ahs_ index], 
é&aggregate_item, 
&dsc_product_identifier length, 
dsc_product_identifier ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Fill in the Product Name item of the Descriptor aggregate. 


ad 
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aggregate _index = 0; 

aggregate_item = DDIF$ DSC_PRODUCT_NAME; 

add_info = CDAS$K_ISO_LATIN1; 

status = cda$store item( &root_aggregate_handle, 54 
saggregate handle stack[ahs index], 
&aggregate item, 
&dsc_product_name_length, 
dsc_product_name, 
&aggregate_ index, 
&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
KKK KKKK KK KKK KK KKK KKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KK KKKKKEKKKKKK 
kK* 


** HEADER: 

K* 

xx 1) create the Header aggregate 

xk 2) attach it to the Root aggregate 

ak 3) fill in the items in the Header aggregate 
K* 


KKKEKKEKKKKKEKK KK KKK KK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KEK KKK KKK KE KKK KKK KK KK KKKKKKKKEK 
wf 


/* 

** Create the Header aggregate and attach it to the Root aggregate 

** by storing its handle in the Header item of the Root aggregate. 

ad 

aggregate type = DDIFS$ _DHD; 

status = cda$create_aggregate( &root_aggregate_ handle, 6] 
s&aggregate_ type, 
&aggregate handle stack[ahs_ index] ); 


if( FAILURE( status ) ) 
return ( status ); 


aggregate item = DDIF$ DDF_HEADER; 

status = cda$store_item( &root_aggregate_handle, 7) 
&root_aggregate_ handle, 
&aggregate item, 
é&aggregate handle length, 
&aggregate_handle_stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
**x Add the style guide reference. 
*/ 


ahs_index++; 
aggregate type = DDIFS ERF; 
status = cda$create_aggregate( &root_aggregate_handle, © 
é&aggregate type, 
é&aggregate_ handle stack[ahs_ index] ); 
if( FAILURE( status ) ). 
return ( status ); 
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aggregate item = DDIF$ DHD EXTERNAL REFERENCES; 

status = cda$store _item( &root_aggregate_handle, © 
&aggregate_ handle stack[ahs_index-1], 
&aggregate item, 
é&aggregate handle length, 
&aggregate_ handle stack[{ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate _ item = DDIF$ ERF_ DATA TYPE; 

status = cdaSstore item( &root_aggregate_handle, ® 
&aggregate handle _stack[ahs_index], 
&aggregate_item, 
&erf data_type_ length, 
erf_data_type ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate_item = DDIF$ ERF_ DESCRIPTOR; 

aggregate index = 0; 

add_info = CDA$K_ISO_LATIN1; 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate_ handle stack[ahs_index], 
&aggregate_ item, 
&erf descriptor_name_ length, 
erf_descriptor_name, 
é&aggregate_index, 
&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate index = 0; 

add_info = CDASK_ISO_LATIN1; 

aggregate_item = DDIFS$_ERF_LABEL; 

status = cda$store_item( &root_aggregate_handle, ® 
&aggregate handle stack[fahs_ index], 
&aggregate_item, 
&erf label_name_length, 
erf_label_name, 
&aggregate_ index, 
&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate_item = DDIFS ERF_ LABEL TYPE; 

add_info = DDIF$K_STYLE_ LABEL TYPE; 

status = cda$store_item( &root_aggregate_handle, 
&aggregate_handle_stack[ahs_ index], 
&aggregate_item, 
g&erf label_type_length, 
erf_label_type, 
0, 

&add_info); 


1f( FAILURE( status ) ) 
return ( status ); 
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aggregate item = DDIF$_ERF CONTROL; 

integer value = DDIFSK_NO COPY REFERENCE; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle _stack[ahs_ index], 
&aggregate_ item, 
&integer length, 
&integer value); 

if( FAILURE( status ) ) 

return ( status ); 


ahs_index--; 


/* 

**x Fill in the Languages item in Header aggregate. First, the enumeration 
*k value must be stored, then the data value. An index must be used since 
** these are arrays. 


ey, 


aggregate item = DDIF$ DHD LANGUAGES C; 

integer value = DDIFSK_ISO 639 LANGUAGE; 

aggregate _ index = 0; 

status = cda$store_item( é&root_aggregate_handle, ® 
é&aggregate_ handle stack[ahs_index], 
&aggregate item, 
&integer length, 
&integer_ value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ _DHD LANGUAGES; 

aggregate index = 0; 

status = cdaSstore item( &root_aggregate handle, ® 
saggregate handle _stack[ahs_index], 
é&aggregate_ item, 
édhd_languages length_i, 
dhd_languages_1, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ DHD LANGUAGES C; 

aggregate_index = 1; 

status = cdaS$store_item( &root_aggregate_ handle, ® 
&aggregate handle _stack[ahs index], 
&aggregate item, 
&integer_length, 
&integer_ value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate _item = DDIF$ DHD LANGUAGES; 

integer value = DDIF$K_OTHER_LANGUAGE; 

aggregate _index = 1; 

add_info = CDASK_ISO_LATIN1; 

status = cda$store_item( &root_aggregate handle, © 
&aggregate_ handle stack[ahs_index], 
&aggregate item, 
&dhd_languages_length_2, 
dhd_languages 2, 
&aggregate_ index, 
&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Add the DHD_ STYLE GUIDE item, defining it to point to the 
*x*x first external reference, which was defined above as the 

** style-guide file. 


ey 
aggregate item = DDIF$ DHD STYLE GUIDE; 
integer_value = 1; 


status = cda$store_item( &root_aggregate_handle, 
&aggregate_ handle stack[ahs_index], 
&aggregate_item, 
é&integer length, 
&integer value); 
if( FAILURE( status ) ) 
return ( status ); 


/* 
RKKKEKEKKKEKKKEKKEKKRKRKEKKRKKKKEKKEKEKRKEKEKKKKRKRKKEKRKEKKRKEKEREREKREKEEKRKREKEKKKKRKKEKEKRKKKEEKER 
xk 

** CONTENT: 

xk : 

ce 1) create the Segment aggregate 

ae 2) attach it to the Root aggregate 

xk 3) fi11 in the items in the Segment aggregate 

*kK* 


RREKKEKKKKEKKEKKKEKKEKKKE KKK KK RKEKKEKKEKKRE KKK KKK RK KKK KK KKK K KKK KEKE KRKKKKKRKEKKEKEKKKKKEKEKKKEE 
S/, 
/* 
** Create the Segment aggregate and attach it to the Root aggregate 
** by storing its handle in the Content item of the Root aggregate. 
x / . 
aggregate type = DDIFS SEG; 
status = cda$create_aggregate( &root_aggregate_handle, 17) 
&aggregate type, 
g&aggregate_handle stack[{ahs_index] ); 
if( FAILURE( status ) ) 
return ( status ); 
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aggregate_item = DDIF$ DDF_CONTENT; 

status = cdaS$store item( &root_aggregate_ handle, ® 
&root_aggregate handle, 
&aggregate item, 
&aggregate handle length, 

/_ &aggregate handle stack[ahs_index] ); 
if( FAILURE( status ) ) 
return ( status ); 


ahs_index++; 
aggregate _type = DDIFS_SEG; 
status = cdaScreate_aggregate( &root_aggregate_handle, ® 
g&aggregate type, 
&aggregate_ handle stack[ahs_ index] ); 
if ( FAILURE( status ) ) 
return ( status ); 


/* Store into this segment. */ 


aggregate_item = DDIF$ SEG CONTENT; 

status = cda$store_item( &root_aggregate_handle, ® 
&aggregate handle stack[ahs_index-1], 
&aggregate item, 
&aggregate handle length, 
&aggregate handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 

** Store the segment type ("PARA"). PARA is defined in the default 

** style guide. 

at f 

aggregate_item = DDIF$ SEG SEGMENT TYPE; 

status = cdaSstore _item( &root_aggregate_handle, @ 
&aggregate handle stack[ahs_index], 
&aggregate item, 
&para_seg type length, 
para_seg type ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 

** Now fill in the items in the Segment aggregate. 

aa 

ahs_index++; 

aggregate type = DDIFS$_ SGA; 

status = cdaScreate_aggregate( &root_aggregate_handle, @ 
&aggregate type, 
&aggregate handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate_item = DDIFS$_SEG SPECIFIC_ATTRIBUTES; 

status = cda$store_item( &root_aggregate_handle, 23) 
éaggregate handle stack[ahs_ index-1], 
gaggregate_item, 
éaggregate handle length, 
saggregate handle stack[ahs_ index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Create a type-definition aggregate and attach to the segment 
xx attribute aggregate. 


wa A 


ahs_indext++; 
aggregate type = DDIF$_TYD; 
status = cda$create _aggregate( &root_aggregate_handle, @ 
&aggregate type, 
&aggregate handle stack[ahs_ index] ); 
if( FAILURE( status ) ) 
return ( status ); 


aggregate _item = DDIF$ _SGA_TYPE_DEFNS; 

status = cdaS$store_item( &root_aggregate handle, @ 
&aggregate handle stack[ahs_index-1], 
&aggregate_ item, 
é&aggregate handle length, 
s&aggregate handle stack[ahs index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Now store the type-definition label. */ 


aggregate item = DDIF$ TYD_ LABEL; 

status = cda$store _item( &root_aggregate handle, ® 
é&aggregate handle stack[ahs_ index], 
é&aggregate item, 
&tyd_label length, 
tyd_label ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 

** Create an attribute aggregate, and attach to the 

** type-def aggregate. 

*/ 

ahs _index++; 

aggregate type = DDIFS$_SGA; 

status = cda$create_aggregate( &root_aggregate_handle, @ 
é&aggregate type, 
&aggregate handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate_item = DDIF$_TYD_ATTRIBUTES; 


status = cda$store_item( é&root_aggregate_ handle, @ 
&aggregate_handle stack[ahs_index-1], 
&aggregate_ item, 
é&aggregate handle length, 
&aggregate handle stack[ahs_ index] ); 
if( FAILURE( status ) ) 
return ( status ); 


/* 
*x* Now that the type-def attributes aggregate is in place, store 
xk each desired attribute there. 

i 


aggregate_item = DDIF$_SGA_CONTENT_ CATEGORY; 

aggregate index = 0; 

add_info = DDIFS$K_2D CATEGORY; 

status = cda$store_ item ( &root_aggregate handle, ® 
&aggregate handle stack[ahs_ index], 
é&aggregate_ item, 
&sga_content_category length_2, 
sga_content_category, 
&aggregate_ index, 
g&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the flags, indicating border on frame. */ 


aggregate_item = DDIF$_SGA_FRM_ FLAGS; 

sga_frame_flags.ddif$v_flow_around = 0; 

sga_frame_flags.ddif$v_frame_ border = 1; 

sga_frame_flags.ddif$v_frame_background_fill = 0; 

sga_frame_flags.ddif$v_frm_fill = 0; 

integer_length = sizeof( sga_frame_flags ); 

status = cda$store_item( &root_aggregate_handle, 30] 
&aggregate handle stack[ahs index], 
&aggregate_item, 
&integer length, 
&sga_frame_flags ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the bounding coordinates of the frame. (Note indexing.) */ 


aggregate _item = DDIF$_SGA_FRM BOX_LL X C; 

integer value = DDIF$K_VALUE_CONSTANT; 

aggregate _ index = 0; 

status = cda$store item( &root_aggregate_handle, @ 
&aggregate handle stack[ahs_index], 
&aggregate item, 
&integer length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate item = DDIF$ SGA_FRM_BOX LL X; 

aggregate index = 0; 

integer_value = 0; 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate_handle_stack[ahs_index], 
&aggregate_item, 
&integer length, 
&integer value, 
éaggregate_index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ _SGA_FRM BOX_LL Y C; 

integer value = DDIF$K_VALUE_CONSTANT; 

aggregate index = 1; 

status = cda$store item( &root_aggregate_ handle, 
s&aggregate_ handle _stack{ahs_index], 
&aggregate_item, 
&integer length, 
&integer_value, 
é&aggregate_index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ SGA_FRM_BOX_LL Y; 

aggregate index = 1; 

integer value = 0; 

status = cda$store_item( &root_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
&aggregate item, 
&integer_ length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


/* And now the upper-right coordinates... */ 


aggregate item = DDIF$ SGA_FRM BOX UR_X C; 

integer value = DDIFSK_VALUE_ CONSTANT; 

aggregate _index = 0; 

status = cda$store_item( &root_aggregate_handle, 

&aggregate_ handle stack[ahs_index], 

&aggregate_item, 
&integer_ length, 
&integer value, 
&aggregate_ index ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate_item = DDIF$_SGA_FRM BOX _UR_X; 

aggregate index = 0; 

integer value = frame_ur_x value; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stackfahs index], 
saggregate item, 
&integer_ length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ SGA_FRM BOX _UR_Y C; 

integer value = DDIF$K_VALUE_CONSTANT; 

aggregate index = 1; 

status = cda$store item( &root_aggregate_ handle, 
&aggregate handle stack[ahs index], 
&aggregate item, 
&integer_ length, 
é&integer value, 
saggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ SGA_FRM BOX _UR_Y; 

aggregate index = 1; 

integer value = frame_ur_y value; 

status = cdaSstore item( &root_aggregate_handle, 
g&aggregate handle stack[ahs_ index], 
&aggregate item, 
é&integer_ length, 
&integer_ value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Now store the form-position item. */ 


aggregate item = DDIFS$ SGA_FRM POSITION C; 

integer _value = DDIF$K_FRAME GALLEY; 

status = cda$store _item( &root_aggregate_handle, 
saggregate handle stack[ahs_ index], 
&aggregate item, 
&integer_ length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


ahs_index--; /* End of type attributes. */ 

ahs_index--; /* End of type-definition */ 

ahs_index--; /* End of segment attributes aggregate. */ 

/* 

** Create Text Content aggregate and store its handle in the SEG CONTENT 
** item in DDF CONTENT. (This is the first aggregate in a Sequence Of, 
** so it is attached with a store. The rest will be inserted.) 

Pi. 
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ahs_index++; 
aggregate type = DDIFS$_TXT; 
status = cda$create_aggregate ( &root_aggregate_handle, @ 
é&aggregate_ type, 
&aggregate handle stack[ahs_ index] ); 
if( FAILURE( status ) ) 
return ( status ); 


aggregate item = DDIF$_SEG CONTENT; 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate handle stack[ahs_index-1], 
&aggregate_ item, 
&aggregate handle length, 
&aggregate handle stack[ahs_ index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 

** Add a text line. 

af 

aggregate item = DDIF$ TXT CONTENT; 

status = cda$store_item( &root_aggregate_handle, 35) 


&aggregate handle stack[ahs_ index], 
é&aggregate item, 
étxt_content_length, 
txt_content ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Save the handle of the segment_content aggregate. */ 
previous aggregate handle = aggregate handle stack[ahs_ index]; 
/* Insert a space (hard) directive. */ 


status = create _hrd_dir ( é&root_aggregate_handle, © 
é&previous aggregate_handle, 
&aggregate_handle_stackfahs_index], 
DDIF$K_DIR_SPACE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Create a General Text Content aggregate. */ 


previous_aggregate handle = aggregate_handle stack[ahs_index]; 


status = create_gtx ( &root_aggregate_handle, @ 
&previous aggregate_handle, 
&aggregate handle stack[ahs_index], 
gtx_content_1 ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert a new-line (hard) directive to force a new line. */ 
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previous aggregate handle = aggregate_handle_stack[ahs_index]; 
status = create _hrd_dir ( &root_aggregate_handle, ® 
&previous aggregate handle, 
&aggregate handle stack[ahs_index], 
DDIFS$K_DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Create another General Text Content aggregate. */ 


previous aggregate handle = aggregate_handle_ stack[ahs_index]; 
status = create gtx ( &root_aggregate_ handle, 
&previous_aggregate_handle, 
&aggregate handle _stack[ahs_index], 
gtx_content_2 ); . 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate handle = aggregate handle stack[ahs_ index]; 
status = create hrd_dir ( é&root_aggregate_handle, 
&previous_ aggregate handle, 
&aggregate handle stack[ahs_index], 
DDIF$K_DIR_NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


previous _aggregate_handle = aggregate handle _stack[{ahs_index]; 
status = create hrd_dir ( &root_aggregate_handle, 
&previous_aggregate_handle, 
&aggregate_ handle stack[ahs_index], 
DDIFS$K_DIR_NEW_LINE ); 
1f( FAILURE( status ) ) 
return ( status ); 


/* Create another General Text Content aggregate. */ 


previous aggregate handle = aggregate _handle_stack[ahs_index]; 
status = create gtx ( &root_aggregate handle, 
&previous_aggregate_handle, 
&aggregate_handle_stack[ahs_index], 
gtx_content 3 ); . 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert a new-page (hard) directive. */ 


previous_aggregate handle = aggregate _handle_stack[ahs_index]; 
status = create_hrd_dir ( é&root_aggregate_handle, 
&previous_aggregate_ handle, 
&aggregate handle stack[ahs_index], 
DDIFSK_DIR_NEW_PAGE ? 
if( FAILURE( status ) ) 
return ( status ); 
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the 


/* Insert next general-text line. */ 


previous aggregate _handle = aggregate_handle_stack[ahs_index]; 
status = create gtx ( &root_aggregate handle, 
&previous_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
"The following is a Bezier curve, using \ 
same path as the polyline, within a frame:" ); 
if( FAILURE( status ) ) 
return ( status ); 


/* 
** Create a new segment aggregate in which to define the polyline, and 
** insert after the previous aggregate. 


ay 


previous_aggregate handle = aggregate_handle_stack{ahs_index]; 
aggregate type = DDIFS$ SEG; 
status = cda$create_aggregate( &root_aggregate_ handle, 39) 
é&aggregate type, 
é&aggregate handle stack[ahs index] ); 
if( FAILURE( status ) ) 
return ( status ); 


/* 
** Insert after previous aggregate. (Insert rather than store, as this 
** is a sequence of aggregates.) 

oe d 


status = cdaS$insert_aggregate( é&aggregate_ handle stack[ahs_index], 
&previous_aggregate_ handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Store the segment ID. */ 


aggregate item = DDIF$_ SEG ID; 

status = cda$store item( &root_aggregate_handle, ® 
&aggregate handle _stack[ahs_ index], 
&aggregate item, 
&pline label length, 
pline_label ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the segment type ("FRAME"). */ 


aggregate_item = DDIF$ SEG SEGMENT TYPE; 

status = cda$store_item( &root_aggregate_ handle, 
&aggregate_ handle stack[ahs_index], 
saggregate_ item, 
&tyd_ label length, 
tyd_label ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Create a Polyline aggregate. */ 
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ahs_indext+; 
aggregate _type = DDIF$ LIN; 
status = cdaScreate_aggregate( &root_aggregate_handle, ® 
é&aggregate type, 
&aggregate handle stack[ahs_index] ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Store the Polyline aggregate. */ 


aggregate item = DDIF$ SEG CONTENT; 

status = cda$store_item( &root_aggregate handle, @ 
&aggregate handle stack[ahs_index-1], 
&aggregate item, 
&aggregate_ handle length, 
&aggregate handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store Polyline Flags into the Polyline aggregate. */ 


aggregate item = DDIF$_LIN FLAGS; 

integer_value = 0x1; 

status = cda$store_item( &root_aggregate_handle, 
g&aggregate handle stack[ahs_index], 
&aggregate_ item, 
&integer_ length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the Line Pattern bit string into the Polyline aggregate. */ 


aggregate _item = DDIF$ LIN DRAW PATTERN; 

integer value = 0xF; 

status = cda$store_item( &root_aggregate_handle, 
&aggregate handle stack{ahs_ index], 
é&aggregate item, 
&integer_length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
**x For the points to be used, store "VALUE CONSTANT" as the data type 
** choice, followed by the value of the point. 

tb 


for (i = 0; i < MAX POINTS; i++ ) 

{ 

aggregate_item = DDIF$ LIN PATH C; 

integer value = DDIFSK_VALUE_CONSTANT; 

aggregate index = i * 2; 

status = cda$store_item( &root_aggregate_handle, ® 
é&aggregate_ handle stack[ahs_ index], 
&aggregate_ item, 
&integer length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 
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/* Store the x-coordinate integer value in the polyline path array. */ 


aggregate_item = DDIF$ LIN PATH; 

integer value = poly points[{i] [0]; 

aggregate_index = i * 2; 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate handle stack[{ahs_ index], 
é&aggregate item, 
&integer_ length, 
&integer value, 
&aggregate_index ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Now store the y-coordinate for each point. 


ars 


aggregate_item = DDIF$ LIN PATH C; 

integer value = DDIFS$K_VALUE_CONSTANT; 

aggregate index = ((2 * i) +1 ); 

status = cdaSstore item( &root_aggregate_ handle, ® 
&aggregate handle stack[fahs_index], 
&aggregate_ item, 
é&integer_ length, 
&integer_value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate_item = DDIF$_LIN_ PATH; 

integer value = poly points[i] [1]; 

aggregate_index = ((2 * i) +1 )z. 

status = cda$store_item( &root_aggregate_handle, ® 
saggregate handle stack[ahs_index], 
&aggregate item, 
&integer_ length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 
}; /* End of "for" loop */ 


ahs_index--; /* End of pline. */ @ 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate handle = aggregate_handle_stack[ahs_index]; 
status = create hrd_dir ( &root_aggregate_handle, ® 
&previous_aggregate_handle, 
saggregate handle stack[ahs_ index], 
DDIF$K_DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 
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previous aggregate handle = aggregate handle _stack[fahs_ index]; 
status = create_hrd dir ( &root_aggregate_handle, 
&previous_aggregate_handle, 
&aggregate handle stack[ahs_index], 
DDIFS$K_DIR_NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert next general-text line. */ 


previous_aggregate handle = aggregate handle stack[ahs_index]; 
status = create gtx ( &root_aggregate_ handle, ® 
&previous_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
"The following is a polyline within a frame:" ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate handle = aggregate_handle_stack[ahs_index]; 
status = create _hrd_dir ( &root_aggregate_handle, @ 
&previous aggregate_handle, 
&aggregate handle stack[ahs_index], 
DDIF$K_DIR_NEW_LINE ); 
Lif( FAILURE( status ) ) 
return ( status ); 


previous aggregate handle = aggregate handle stack{ahs_index]; 
status = create _hrd_dir ( &root_aggregate_handle, 
&previous_aggregate_handle, 
g&aggregate handle stack[ahs_index], 
DDIF$K_DIR_NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert two new-line directives to cause a skipped line. */ 


previous_aggregate handle = aggregate_handle stack[ahs_index]; 
status = create_hrd_dir ( é&root_aggregate_handle, 
&previous aggregate handle, 
&aggregate handle stack[ahs_ index], 
DDIF$K_DIR_NEW_LINE ); 
if( FAILURE( status ) )  — 
return ( status ); 


previous aggregate handle = aggregate_handle stack[ahs_index]; 
status = create_hrd dir ( &root_aggregate_handle, 
&previous_aggregate_handle, 
saggregate handle stack[ahs_ index], 
DDIF$K_DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* 
xx Create new segment to define Bezier curve. 


a 
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previous_aggregate handle = aggregate handle stack[ahs_ index]; 
aggregate type = DDIF$ SEG; 
status = cda$create_aggregate( &root_aggregate_handle, @ 
é&aggregate type, 
&aggregate handle stack[ahs_index] 
if( FAILURE( status ) ) 
return ( status ); 


/* 


**x Insert after previous aggregate. (Insert rather than store, as 


** this is a sequence of aggregates.) 


al 4 


status = cda$insert_aggregate( é&aggregate_ handle stack[ahs index], 


&previous_aggregate_handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Store the segment ID. */ 


aggregate item = DDIFS$_SEG ID; 

status = cda$store_item( &root_aggregate_ handle, @ 
&aggregate handle _stack[ahs_index], 
é&aggregate item, 
&bline label length, 
bline_ label ); 

if( FAILURE( status ) ) 

return (. status’); 


/* Store the segment type ("FRAME"). */ 


aggregate _ item = DDIF$ SEG SEGMENT TYPE; 

status = cda$store_item( &root_aggregate_ handle, 
&aggregate handle stack[ahs_index], 
&aggregate_item, 
&tyd_label_ length, 
tyd_label ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Create a Bezier Curve aggregate. */ 


aggregate type = DDIFS_BEZ; 

previous_aggregate handle = aggregate handle stack[ahs_index]; 

ahs_index++; 

status = cda$create_aggregate( &root_aggregate_handle, @ 
é&aggregate type, 
g&aggregate handle stack[ahs_ index] 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the Bezier Curve aggregate */ 


aggregate item = DDIF$_SEG CONTENT; 

status = cda$store item( &root_aggregate_ handle, @ 
é&aggregate_ handle stackfahs_index-1], 
é&aggregate item, 
é&aggregate_handle length, 
é&aggregate_handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


ie 


); 
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/* 
agg 


Store the Flags item into the Bezier Curve aggregate. */ 


regate item = DDIF$ BEZ FLAGS; 


integer value = Oxl; 
status = cda$store_item( &root_aggregate_handle, 


Lf ( 


/* 


&aggregate handle stack[ahs_ index], 
é&aggregate_ item, 
&integer_length, 
&integer value ); 
FAILURE( status ) ) 
return ( status ); 


** For the points to be used, store "VALUE CONSTANT" as the data type 


* 
“7 


for 





choice, followed by the value of the point. 


(i = 0; i < MAX POINTS; i++ ) 

{ 

aggregate item = DDIF$ BEZ PATH C; 

integer value = DDIFS$K_VALUE_CONSTANT; 

aggregate_index = i * 2; 

status = cdaSstore_item( &root_aggregate_handle, ® 
&aggregate handle stack[fahs_ index], 
&aggregate item, 
&integer length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the x-coordinate integer value in the polyline path array. */ 


aggregate item = DDIF$ BEZ PATH; 

integer _value = poly points[i] [0]; 

aggregate index = i * 2; 

status = cda$store_item( &root_aggregate_handle, 50) 
&aggregate handle stack[ahs_index], 
&aggregate item, 
&integer_length, 
&integer value, 
&aggregate index ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Now store the y-coordinate for each point. 


*7 


aggregate item = DDIF$ BEZ PATH C; 

integer value = DDIFSK_VALUE_CONSTANT; 

aggregate_index = ((2 * i) + 1); 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate handle stack[ahs index], 
&aggregate item, 
&integer_ length, 
&integer value, 
g&aggregate_ index ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate_item = DDIF$_BEZ PATH; 

integer value = poly points[i] [1]; 

aggregate index = ((2 * i) +1); 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate_handle_ stack[ahs_index], 
&aggregate_item, 
é&integer length, 
&integer value, 
&aggregate_index ); 

if( FAILURE( status ) ) 

return ( status ); 
}; /* End of "for" loop */ 


ahs_index--; /* End of Bezier segment */ 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate handle = aggregate handle _stack[ahs_index]; 


status = create_hrd dir ( &root_aggregate_ handle, @ 
é&previous_aggregate_handle, 
&aggregate handle stack[ahs_index], 
DDIF$K DIR _NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


previous aggregate handle = aggregate_handle_ stack[ahs_index]; 
status = create _hrd dir ( &root_aggregate_handle, 
&previous_aggregate_handle, 
é&aggregate_handle stack[ahs_ index], 
DDIFS$K_DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert next general-text line. */ 


previous_aggregate handle = aggregate _handle_stack[ahs_index]; 
status = create _gtx ( é&root_aggregate handle, @ 
&previous_aggregate_handle, 
é&aggregate_handle stack[ahs_ index], 
"The following is a basketweave-filled arc \ 
within a frame:" ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate handle = aggregate handle stack[ahs_ index]; 


status = create_hrd_ dir ( &root_aggregate_handle, @ 
&previous_aggregate_handle, 
é&aggregatée_ handle stack[ahs_ index], 
DDIF$K_DIR_NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


previous aggregate handle = aggregate_handle_ stack[ahs_index]; 
status = create hrd_dir ( &root_aggregate_ handle, 
&previous_aggregate_handle, 
&aggregate_ handle stack[ahs_index], 
DDIF$K_DIR_NEW_LINE ); 
if( FAILURE( status ) ) 
return ( status ); 
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/* 
*k Create new segment to define special segment attributes for 
** the arc. 


ia 


previous_aggregate handle = aggregate_handle_stack[ahs_index]; 
aggregate type = DDIFS$_ SEG; 
status = cda$create_aggregate( s&root_aggregate_ handle, @ 
&aggregate type, 
saggregate handle stack[ahs index] ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert after previous aggregate. */ 


status = cdaSinsert_aggregate( &aggregate_ handle stack[ahs_ index], 
. &previous_aggregate_ handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Store the segment ID. */ 


aggregate item = DDIFS$ SEG _ID; 

status = cda$store item( &root_aggregate_handle, @ 
&aggregate handle stack[ahs_ index], 
&aggregate item, 
&filled_arc_label_ length, 
filled_arc label ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the segment type ("FRAME"). */ 


aggregate item = DDIF$ SEG SEGMENT TYPE; 
status = cda$store_item( &root_aggregate_handle, 
&aggregate handle stack[ahs_index], 
&aggregate_ item, 
&tyd_ label length, 
tyd_label ); 
if( FAILURE( status ) ) 3 
return ( status ); 


/* 

**k Create a segment aggregate and store in the seg-content item. 

ut 

ahs_index++; 

aggregate _ type = DDIFS$ SEG; 

status = cdaScreate_aggregate( &root_aggregate_handle, @ 
é&aggregate type, 
&aggregate_ handle stack[{ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 
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aggregate item = DDIFS SEG CONTENT; 

status = cda$store item( &root_aggregate_handle, 65) 
saggregate handle stack[ahs_index-1], 
&aggregate_ item, 
&aggregate handle length, 
&aggregate handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


hs 
** Create new segment attributes aggregate to define the arc’s 
** attributes, and store it in the segment aggregate just created. 


xy. 


ahs_index++; 
aggregate type = DDIF$_SGA; 
status = cda$create_aggregate( &root_aggregate_handle, ® 
é&aggregate type, 
&aggregate handle stack[ahs_index] ); 
if( FAILURE( status ) ) 
return ( status ); 


aggregate item = DDIF$ SEG SPECIFIC_ATTRIBUTES; 

status = cda$store_item( &root_aggregate_handle, @ 
&aggregate_handle_stack[ahs_index-1], 
é&aggregate_ item, 
&aggregate_ handle length, 
&aggregate_ handle stack[ahs_index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* 
** Now store the specific attributes for the arc. 


wg 


aggregate item = DDIF$_SGA_LIN WIDTH C; 

integer _value = DDIF$K_VALUE_CONSTANT; 

status = cda$store_item( &root_aggregate_handle, 
saggregate handle stack[ahs_ index], 
&aggregate_ item, 
&integer_length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIFS SGA_LIN WIDTH; 

integer value = arc_line width; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle _stack[ahs_index], 
&aggregate_item, 
&integer_length, 
&integer_ value ); 

if( FAILURE( status ) ) 

return ( status ); 





(continued on next page) 


CDA Toolkit Example Program 10-25 


Example 10-1 (Cont.): Sample CDA Toolkit Program 


aggregate_item = DDIF$ SGA_LIN_STYLE; 

integer _value = DDIFSK_SOLID_LINE_ STYLE; 

status = cdaSstore item( &root_aggregate_handle, 
&aggregate handle _stack[ahs_index], 
&aggregate_item, 
&integer_ length, 
&integer_value ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ _SGA_LIN_END_START; 

integer value = DDIF$K_ROUND_LINE_ END; 

status = cda$store item( é&root_aggregate_handle, 
&aggregate_ handle stack[{ahs_index], 
saggregate item, 
&integer length, 
&integer_ value ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ SGA_LIN_END FINISH; 

integer value = DDIF$K_ROUND_LINE_END; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[{ahs_ index], 
s&aggregate item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$_SGA_LIN_ JOIN; 

integer_value = DDIF$K_MITERED LINE _JOIN; 

status = cda$store item( é&root_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
&aggregate item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


aggregate item = DDIF$ SGA_LIN_INTERIOR_PATTERN; 

integer value = DDIF$K_PATT BASKET WEAVE; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_index], 
&aggregate item, 
&integer length, 
&integer value ); 

if ( FAILURE( status ) ) 

return ( status ); 


ahs_index--; /* End of line attributes */ ® 
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/* Create an Arc Content aggregate. */ 


aggregate _type = DDIFS$ ARC; 
previous_aggregate handle = aggregate handle stack[ahs_ index]; 
ahs_index++; 
status = cda$create_aggregate( &root_aggregate_handle, @ 
é&éaggregate type, 
&aggregate_handle_stackfahs_index] ); 
if( FAILURE( status ) ) 
return ( status ); 


/* 

** Store the arc-content aggregate as the seg content of the previous 

xx aggregate. 

z7 

aggregate item = DDIFS_SEG CONTENT; 

status = cda$store item( &root_aggregate_handle, @ 
&aggregate_handle_stack[ahs_index-1], 
&aggregate_ item, 
&aggregate handle length, 
é&aggregate handle _stack[ahs_ index] ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store the Flags item into the are aggregate. */ 


set_arc_ flags.ddif$v_arc_draw_arec = 1; 
set_arc_flags.ddif$v_arc_fill_arec = 1; 
set_arc_flags.ddif$v_arc_pie arc = 1; 
set_arc_flags.ddifSv_arc close arc = 0; 
set_arc_flags.ddif$v_arc_flags_fill = 0; 


aggregate item = DDIFS ARC_FLAGS; 
status = cda$store_item( &root_aggregate_handle, 
é&aggregate handle stack[ahs index], 

&aggregate_item, 
&integer_ length, 
&set_arc flags ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store "VALUE CONSTANT" as the data type choice for the arc 
center x-coordinate. */ 


aggregate_item = DDIF$ ARC_CENTER_X _C; 

integer value = DDIFS$K_VALUE_ CONSTANT; 

status = cda$store item( &root_aggregate_handle, 
&aggregate_ handle stack[ahs_index], 
&aggregate_item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 
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/* Store an integer value for the arc center x-coordinate. */ 


aggregate _item = DDIF$ ARC_CENTER_X; 

integer value = 3000; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
saggregate item, 
&integer_length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store "VALUE CONSTANT" as the data type choice for the arc 
center y-coordinate. */ 


aggregate item = DDIF$ ARC _CENTER_Y C; 

integer value = DDIFSK_VALUE_CONSTANT; 

status = cda$store item( &root_aggregate_handle, 
&aggregate_ handle stack[ahs_index], 
&aggregate_item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store an integer value for the arc center y-coordinate. */ 


aggregate item = DDIFS$ ARC CENTER_Y; 

integer value = 150; 

status = cdaSstore item( é&root_aggregate_handle, 
&aggregate handle stack[ahs_index], 
g&aggregate_item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store "VALUE CONSTANT" as the data type choice for the arc 
radius x value. */ 


aggregate item = DDIF$ _ARC_RADIUS X C; 

integer value = DDIF$K_VALUE_CONSTANT; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_ index], 
&aggregate_item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store an integer value for the arc radius x value. */ 


aggregate_item = DDIF$_ARC_RADIUS X; 

integer value = 2000; 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_index], 
&aggregate item, 
&integer_ length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 
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/* Store "ANGLE CONSTANT" as the data type choice for the arc 
start value. */ 


aggregate item = DDIF$ ARC START C; 

integer value = DDIF$K_ANGLE_ CONSTANT; 

status = cdaS$store_item( &root_aggregate_ handle, 
&aggregate handle stack[ahs_index], 
&aggregate_ item, 
&integer length, 
&integer_ value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store an integer value for the are start value. */ 


aggregate item = DDIF$ ARC START; 

local_length = sizeof( arc_start ); 

status = cda$store item( &root_aggregate_handle, 
&aggregate handle stack[ahs_index], 
é&aggregate item, 
&local_length, 
.&€arc_ start ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store "ANGLE CONSTANT" as the data type choice for the arc 
EXTENT value. */ 


aggregate item = DDIF$ ARC EXTENT C; 

integer value = DDIFS$K_ANGLE CONSTANT; 

status = cda$store_item( &root_aggregate_handle, 
é&aggregate handle stack[ahs_ index], 
é&aggregate_item, 
&integer_ length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


/* Store an integer value for the arc EXTENT value. */ 


aggregate _ item = DDIF$ ARC_EXTENT; 

local_length = sizeof( arc_extent ); 

status = cdaS$store item( &root_aggregate_ handle, 
é&aggregate_ handle stack[ahs_ index], 
&aggregate_ item, 
&local_length, 
é&arc_extent ); 

if( FAILURE( status ) ) 

return ( status ); 


ahs _index--; /* End of arc. */ 
ahs_index--; /* End of arc-attribute segment */ 


/* Insert two new-line directives to cause a skipped line. */ 


previous aggregate _handle = aggregate handle stack[ahs_index]; 
status = create hrd dir ( é&root_aggregate_ handle, @ 
&previous_ aggregate handle, 
é&aggregate_ handle stack[ahs index], 
DDIF$K_DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 
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previous_aggregate handle = aggregate_handle_stack[ahs_index]; 
status = create hrd_dir ( &root_aggregate_handle, 
&previous aggregate handle, 
&aggregate_ handle stack[ahs_index], 
DDIF$K DIR_NEW LINE ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert next general-text line. */ 


previous_aggregate handle = aggregate handle_stack[ahs_index]; 

status = create_gtx ( &root_aggregate_handle, @ 
&previous_aggregate_handle, 
&aggregate_handle_stack[ahs_index], 


"This ends the examples." ); 
if( FAILURE( status ) ) 
return ( status ); 
ahs_index--; /* End of image segment */ 


ahs_index--; /* End of document content. */ 


/* Create an output file to receive the DDIF stream. */ 


status = cda$create file( &filename_length, 
filename, 
0, 0, 0, O, 0, 
é&root_aggregate_ handle, 
&result_ file spec_len, 
result_file_ spec, 
&result file spec len, 
&stream_ handle, 
&file_handle, 
&root_aggregate handle ); 
if( FAILURE( status ) ) 
return ( status ); 


result_file spec[result_file_spec_len] = 0; 
printf ("Created file: @s\n",result_ file spec ); 
/* Write the DDIF stream to the output file */ 
printf ("Writing document...\n" ); 


status = cda$put_document ( &root_aggregate_handle, 
&stream_handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Close the output file. */ 


status = cda$close file( &stream_handle, 
&file handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Delete the Root aggregate structure. */ 


status = cda$delete_root_aggregate( &root_aggregate handle ); 
if( FAILURE( status ) ) 
return ( status ); 


return; 
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/* 
**x This routine creates a hard-directive aggregate for the specified 
** directive type, and inserts it after the specified previous 

** aggregate. It returns the handle of the newly-created aggregate. 
*/ 


unsigned long create _hrd_dir (root_handle, 
previous handle, 
return_handle, 


dir type ) 
unsigned long *root_handle; /* Root aggregate handle. */ 
unsigned long *previous_handle; /* previous handle */ 
unsigned long *return_handle; /* Handle to be returned. */ 
unsigned long dir type; /* Directive item code. */ 


{ 

unsigned long aggregate_handle; 

unsigned long aggregate_handle length = sizeof( aggregate_handle ); 
unsigned long aggregate type; 

unsigned long aggregate_item; 

unsigned long integer value; 

unsigned long integer length = sizeof( integer value ); 

unsigned long status; 


/* Create a Hard Directive aggregate. */ 


aggregate_type = DDIF$_HRD; 
status = cdaS$create aggregate (root_handle, 
é&aggregate type, 
é&aggregate handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert the Hard Directive aggregate in the sequence of aggregates. */ 


status = cdaSinsert_aggregate( &aggregate_handle, 
previous handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Store the designated directive as an item in the 
Hard Directive aggregate. */ 


aggregate_item = DDIF$ HRD DIRECTIVE; 

integer value = dir type; 

status = cda$store_item(root_handle, 
é&aggregate_ handle, 
saggregate item, 
&integer length, 
&integer value ); 

if( FAILURE( status ) ) 

return ( status ); 


*return_handle = aggregate_handle; 


return(1 ); 
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/* 


Sample CDA Toolkit Program 


** This routine creates a general-text aggregate for the specified 


** text, and inserts it after the specified previous 


aggregate. It 


** returns the handle of the newly-created aggregate. 


bit d 


unsigned long create _ gtx (root_handle, 


previous_handle, 
return handle, 


gtx_string ) 
unsigned long *root_handle; /* Root aggregate handle. */ 
unsigned long *previous_handle; /* previous handle */ 
unsigned long *return_handle; /* Handle to be returned. */ 
char *gtx_ string; /* Ptr to text string. */ 
{ 
unsigned long aggregate_handle; 
unsigned long aggregate_handle length = sizeof( aggregate_handle ); 
unsigned long aggregate _ type; 
unsigned long aggregate_item; 
unsigned long add_info; 
unsigned long integer value; 
unsigned long local_length; 
unsigned long status; 


/* Create another General Text Content aggregate. */ 


aggregate type = DDIF$ GTX; 
status = cdaScreate_aggregate(root_handle, 
é&aggregate_ type, 
é&aggregate handle ); 
if( FAILURE( status ) ) 
return ( status ); 


/* Insert the Text aggregate in the sequence of aggregates. */ 


status = cdaSinsert_aggregate( &aggregate_handle, 
previous_handle ); 
if( FAILURE( status ) ) 


return ( status ); 


/* Store more text into the General Text aggregate. */ 


aggregate_item = DDIF$_GTX_CONTENT; 


add_info = CDASK_ISO_LATIN1; 
local_length = strlen( gtx_string ); 
status = cda$store_item(root_handle, 


&aggregate_ handle, 
&aggregate_ item, 
é&local_length, 
gtx string, 
0, 
&add_info ); 

if( FAILURE( status ) ) 

return ( status ); 


*return_handle = aggregate _handle; 
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return(1 ); 


Example 10-2 illustrates the Analysis output of the DDIF document created 
by Example 10-1. The callouts in Example 10-1 correspond to the callouts in 
Example 10~2. 


In the Analysis output of a DDIF file, the following symbols are used. 
e A left brace indicates the beginning of an aggregate. 

¢ A right brace indicates the end of an aggregate. 

e A left parenthesis indicates the beginning of an array. 


e A right parenthesis indicates the end of an array. 


Additionally, in this example all hexadecimal values produced by the Analysis 
back end have been restored to their ASCII representations. 


Note that default values are indicated by the comment “[Default value.]”. These 
values are not specified in Example 10-1; instead, the default values specified by 
the CDA Toolkit are accepted. 


Example 10-2: Analysis Output of DDIF File 


DDIF_DOCUMENT 


0 | 
© DDF_DESCRIPTOR 
Qe | 
@ DSC _MAJOR_VERSION 1 ! Longword Integer 
DSC_MINOR_VERSION 0 ! Longword Integer 
DSC_PRODUCT_ IDENTIFIER "DDIFS$" 
DSC_PRODUCT_NAME 
( 
@ Iso _LATINI "Test v1.0" 
) 
} 
@ DDF_HEADER 
{ 
© pdHD_ EXTERNAL REFERENCES 
Oo ¢ 
@ ERF DATA TYPE 
( 
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1 ! Object Identifier 

3 ! Object Identifier 

12 ! Object Identifier 
1011 ! Object Identifier 
1 ! Object Identifier 

3 ! Object Identifier 

1 ! Object Identifier 


) 
ERF_DESCRIPTOR 
( 

@ ISO _LATINI "Style Guide" 
) 

® ERF_ LABEL ISO _LATINI "defstyle" ! Char. string. 
ERF_LABEL TYPE STYLE_LABEL TYPE -"SSTYLE" 
ERF_CONTROL NO COPY REFERENCE ! Integer = 2 

} 


DHD_LANGUAGES_C 
( 


@ 150 639 LANGUAGE ! Integer = 0 

@ Iso 639 LANGUAGE ! Integer = 0 
) 
DHD_LANGUAGES 
( 

4 "Er /USA/" ; 

"Mandarin" 

) 
DHD_ STYLE GUIDE 1 ! Longword Integer 


} 
® ppr_conTent 


@ | 


@ sEG CONTENT 


® 

@ SEG SEGMENT TYPE "PARA" 

@ sEG SPECIFIC ATTRIBUTES 

@ { 

@®  SGA_TYPE DEFNS 

@ | 

® TYD LABEL "FRAME" 

@ TYD ATTRIBUTES 

@ { 

® SGA_CONTENT_ CATEGORY TWOD CATEGORY "$2D" 

® SGA'FRM FLAGS "%B01000000000000000000000000000000" ! Flags 

@ SGA_FRM BOX LL XC VALUE_CONSTANT ! Integer = 0 

@ SGA_FRM BOX LL X 0 ! Longword Integer 
SGA_FRM BOX_LL_Y C VALUE_CONSTANT ! Integer = 0 
SGA_FRM BOX_LL Y 0O ! Longword Integer 
SGA_FRM BOX_UR_X_C VALUE_CONSTANT ! Integer = 0 
SGA_FRM_BOX_UR_X 6000 ! Longword Integer 
SGA_FRM BOX_UR_Y_C VALUE_CONSTANT ! Integer = 0 
SGA_FRM_BOX_UR_Y 2400 ! Longword Integer 
SGA_FRM POSITION C FRAME GALLEY ! Integer = 2 
SGA_FRMGLY VERTICAL FRMGLY_BELOW CURRENT ! Integer = 1 [Default] 
SGA_FRMGLY HORIZONTAL FMT _CENTER_OF PATH ! Integer = 2 [Default] 
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SEG CONTENT 
{ 
TXT_CONTENT "This is the first line of the example text." 
} 
{ 
HRD DIRECTIVE DIR_SPACE ! Integer = 5 
} 
{ 
GTX_CONTENT ISO_LATIN1 "This is the second line of the example text, 
and should be separated from the first line by a single space." ! Char. string. 
} 
{ 
HRD DIRECTIVE DIR_NEW_LINE ! Integer = 2 
} 
{ 
GTX CONTENT ISO LATINI "The third line of the example text will 
begin on a new line." ! Char. string. 


} 
{ 


HRD DIRECTIVE DIR _NEW_LINE 


} 
{ 


HRD DIRECTIVE DIR_NEW_ LINE 


} 
{ 


GTX CONTENT ISO LATIN1 


Il 
ht 


Integer 


Hl 
N 


Integer 


"The fourth line of the example text will be 


separated from the previous lines by a blank line, and will be the last 
string. 


text on the first page." ! Char. 


same path as the polyline, 


{ 


} 
{ 


HRD DIRECTIVE DIR_NEW_PAGE 


} 
{ 


GTX_CONTENT ISO_LATIN1 
within a frame:" 


} 


SEG ID "pline" 


. 


Integer = l 


"The following is a Bezier curve, using the 


Char. string. 


SEG SEGMENT TYPE "FRAME" 
SEG CONTENT 
{ 
LIN FLAGS "%B10000000000000000000000000000000" ! Flags 
LIN DRAW PATTERN "%B1111" ! Bit string 
LIN PATH C 
( 
VALUE_CONSTANT ! Integer = 
VALUE_CONSTANT ! Integer = 
VALUE_CONSTANT ! Integer = 0 
VALUE_CONSTANT ! Integer = 0 
VALUE_CONSTANT ! Integer = 0 
VALUE_CONSTANT ! Integer = 0 
VALUE CONSTANT ! Integer = 0 
VALUE_CONSTANT ! Integer = 0 
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@ 


@ 
@ 


@ 
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{ 


500 ! 
ou0. 4 


LIN PATH 


( 


Integer 
Integer 


2500 
2000 
3500 
2000 
5500 
500 


! 
: 
! 
! 
! 


Ir 


Integer 
Integer 
Integer 
Integer 
Integer 
nteger 


HRD_DIRECTIVE DIR_NEW LINE 


} 
{ 


HRD DIRECTIVE DIR_NEW_LINE 


} 


GTX_CONTENT 


within a frame:" 


{ 


SEG_ID 


} 


HRD DIRECTIVE 


} 
{ 


HRD_DIRECTIVE 


} 
{ 


! Char. 


string. 


ISO _LATIN1 


DIR_NEW_LINE 


DIR_NEW_LINE 


HRD DIRECTIVE DIR_NEW_LINE 


} 
{ 


HRD DIRECTIVE 


} 


"blaine" 


SEG SEGMENT TYPE 


SEG CONTENT 


{ 


BEZ FLAGS 


"SB10000000000000000000000000000000" ! 


BEZ PATH C 


( 


VALUE CONSTANT §! 


VALUE CONSTANT ! 
VALUE_CONSTANT 
VALUE_CONSTANT 
VALUE_CONSTANT 
VALUE_CONSTANT 
VALUE_CONSTANT 
VALUE_CONSTANT 


Integer 
Integer = 
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0 
0 


DIR_NEW_LINE 


“PRAME" 


Integer = 


Integer 
Integer 
Integer 
Integer 
Integer 


| 
Qo0000 


Analysis Output of DDIF File 


Integer 


Integer 


Integer 


Integer 


Integer 


Integer 





"The following is a polyline 


Flags 
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BEZ PATH 
( 
500 ! Integer 
500 ! Integer 
2500 ! Integer 
2000 ! Integer 
3500 ! Integer 
2000 ! Integer 
5500 ! Integer 
500 ! Integer 


HRD DIRECTIVE DIR NEW LINE ! 
} 
{ 
HRD DIRECTIVE DIR_NEW LINE ! 
} 


Integer 


Integer 


{ 
GTX_CONTENT ISO_LATIN1 


basketweave-filled arc within a frame:" 


} 


"The following 
t Char. string 


{ 
HRD DIRECTIVE DIR NEW LINE ! 
} 
{ 
HRD DIRECTIVE DIR NEW LINE ! 


} 


Integer 


Integer 


{ 


SEG ID "filled_arc" 


SEG_SEGMENT TYPE "FRAME" 
SEG CONTENT 


{ 
SEG_SPECIFIC_ATTRIBUTES 


{ 


SGA_LIN WIDTH C VALUE CONSTANT ! In 
SGA_LIN WIDTH 60 ! Longword Integer 
SGA_LIN STYLE SOLID _LINE STYLE ! In 
SGA_LIN END START ROUND LINE END ! 
SGA_LIN_ END FINISH ROUND LINE END ! 
SGA_LIN JOIN MITERED LINE JOIN ! In 


SGA_LIN_INTERIOR_PATTERN 41 ! 


isa 


N 


teger 


L 


teger 

Integer 
Integer 

teger 


2 
2 


1 


Longword Integer 
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@ SEG_CONTENT 
@ { 
ARC_FLAGS "%B11100000000000000000000000000000" ! Flags 
ARC_CENTER_X C VALUE_CONSTANT ! Integer = 0 
ARC_CENTER_X 3000 ! Longword Integer 
ARC_CENTER_Y_C VALUE_CONSTANT ! Integer = 0 
ARC_CENTER_Y 150 ! Longword Integer 
ARC_RADIUS X C VALUE _CONSTANT ! Integer = 0 
ARC_RADIUS X 2000 ! Longword Integer 
ARC_RADIUS DELTA_Y_C VALUE_CONSTANT ! Integer = 0 [Default] 
ARC_RADIUS DELTA _Y 0 ! Longword Integer [Default] 
ARC_START_C ANGLE CONSTANT ! Integer = 0 
ARC_START "%F4.500000e+01" ! Single Prec. Floating Point 
ARC_EXTENT C ANGLE CONSTANT ! Integer = 0 
ARC_EXTENT "SF9.000000e+01" ! Single Prec. Floating Point 
ARC_ROTATION C ANGLE CONSTANT ! Integer = 0 [Default] 
ARC_ROTATION "%SF0.000000e+00" ! Single Prec. Floating Point [Default] 
} 
} 
} 
@ | 
HRD DIRECTIVE DIR_NEW_ LINE ! Integer = 2 
} 
{ 
HRD DIRECTIVE DIR_NEW LINE ! Integer = 2 
} 
@ | 
GTX CONTENT ISO LATIN1 "This ends the examples." ! Char. string. 


} 
} 
} 
} 
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Chapter 11 


CDA Converter Routines 


This chapter provides detailed discussions of the converter routines and the 
VMS and ULTRIX compile and link procedures that applications must create in 
writing CDA-conforming front and back ends. Each routine description includes 
the following information: 


e A routine definition that each application must name according to its 
operating system-specific format 


e Descriptions of each routine argument 

e A description of the routine itself 

e A list of possible values returned by each routine argument 

NOTE 

The entry points and conventions defined throughout this reference 
section must be followed on both VMS and ULTRIX systems in order 
for all front and back ends to work properly with the CDA Converter 
Kernel. 


If you are programming in Ada, please refer to the Guide to Applications 
Programming for information on Ada programming with DECwindows. 


11.1. Compile and Link Procedures for Converter Images 


To create a VMS or ULTRIX front or back end image using the CDA Toolkit 
routines, include the following public files in your source code: 


VMS and ULTRIX 

File Names Description 
SYS$LIBRARY:cda$def.h CDA Toolkit keyword definitions 
/asr/include/cda_def.h 

SYS$LIBRARY:ddif$def.h DDIF aggregate definitions 
/asr/include/ddif_def.h 

SYS$LIBRARY:dtif$def.h DTIF aggregate definitions 
/asr/include/dtif_def.h 

SYS$LIBRARY:cda$msg.h CDA error messages 


/usr/include/cda_msg.h 
Section 11.1.1 describes the VMS compile and link procedure for CDA converters. 


Section 11.1.2 describes the ULTRIX compile and link procedure for CDA 
converters. 
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You can compile and link a front end on VMS using the following build procedure: 


§ ce ddifSevt sre:cdasrtx 
$ link /share=ddif$read_text - 
sysSinput:/option 
identification="DECwindows v1.0" 
universal = ddif$read_text 
gsmatch=lequal,1,0 
psect=$char_ string constant, shr,exe,nowrt 
psect=Sdata,shr,exe,nowrt 
cdaSrtx 
sysS$library:cdaSaccess/share 
sysS$share:vaxcrtl/share 


‘You can compile and link a back end on VMS using the following build procedure: 


& cc ddifSevt srescdasrtx 
§ link /share=ddif$write text - 
sysSinput:/option 
identification="DECwindows v1.0" 
universal = ddif$write text 
gsmatch=lequal,1,0 
psect=Schar_string_constant, shr, exe, nowrt 
psect=Sdata, shr, exe, nowrt 
cdaSrtx 
sysSlibrary:cdaSaccess/share 
sysSshare:vaxcrtl/share 


Note that this compile and link procedure does not provide debugging. 


When the build is complete, define a logical named domain$read_format that 
points to your executable image so that the CONVERT/DOCUMENT or cdoc 
command will locate your converter when the CDA$_INPUT_FORMAT value (for 
front ends) or the CDA$_OUTPUT_FORMAT value (for back ends) is passed into 
the std-item list. 


11.1.2 ULTRIX Compile and Link Procedure 


You can compile and link a front end on ULTRIX using the following build 
procedure: 


% cc -o ddif_read_ myformat ddif_read_myformat.c - 


-lddif_fe -lddif -1m 
You can compile and link a back end on ULTRIX using the following build 
procedure: 
% cc ~-o ddif_write myformat ddif_ write myformat.c - 
-lddif be -lddif -1lm 
In the build procedure for a front end or back end on ULTRIX systems, the -lm 


parameter specifies the math library that is required by the CDA Toolkit routines 
(-Iddif). 

When the build procedure on ULTRIX systems is complete, you should store the 
output file in the /usr/bin directory for use with the cdoe command. Alternatively, 
you can define CDAPATH (an environment variable) to be the directory containing 
your front end or back end. The CDA Converter Kernel searches CDAPATH first 
when you invoke the cdoc command. 
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Close Entry Point 


FORMAT 


Terminates the operation of a front end by closing all open files and releasing all 
dynamic memory and other resources that have been allocated by the front end. 
The close routine is one of the routines that compose a front end. 


status = close-procedure 
(front-end-context) 


Argument Information 


RETURNS 


Argument Argument Information 

status Usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

front-end-context Usage: context 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

status 


_A condition value indicating the return status of the routine call. 


front-end-context 
Context returned by either ddif$read_format or dtif$read_format. 


The front-end-context argument is the address of an unsigned longword that 
contains this context. This context must specify the input file or stream to be 
closed. 
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Description 


In the document method of conversion, the input file or stream has already been 
closed by the ddif$read_format or dtif$read_format routine. Therefore, the close 
routine simply performs regular cleanup operations and returns control to the 
CDA Converter Kernel. 


In the aggregate method of conversion, the close routine must close the currently 
open file or stream in addition to performing the regular cleanup work. If the 
format of the input file is not DDIF, DTIF, or Text, the front end must supply its 
own file-closing capability, typically through the use of the RMS $CLOSE service, 
or the close C run-time library routine or equivalent language statement. Once 
all cleanup work has been completed, the close routine passes control back to the 
CDA Converter Kernel. 


The name of this routine is defined by the user. The front end simply returns the 
address of this routine to the CDA Converter Kernel. 


RETURN VALUES. 


Return Value Description 


CDA$_NORMAL Normal successful completion 


The close routine can also return any front end-specific error conditions. 
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Get-Aggregate Entry Point 


Returns the next aggregate in the document to the converter kernel. The get- 
aggregate routine is one of the routines that compose a front end. 


FORMAT 
status = get-aggregate-procedure 
(front-end-context ,aggregate-handle 
,aggregate-type) 


Argument Information 


RETURNS 


Argument Argument Information 
status Usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 
front-end-context Usage: context 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 
aggregate-handle Usage: identifier 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 
aggregate-type Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


status 


A condition value indicating the return status of the routine call. 
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Description 


front-end-context 
Context returned from either ddif$read_format or dtif$read_format. 


The front-end-context argument is the address of an unsigned longword that 
contains this context. Typically, this argument is used to specify the type of 
content aggregate to be created by the get-aggregate routine. 


aggregate-handle 

Receives the handle of the created and populated aggregate. The aggregate- 
handle argument is the address of an unsigned longword that receives this 
aggregate handle. This handle must be used in all subsequent operations on that 


aggregate. 


aggregate-type 

Receives the aggregate type. The aggregate-type argument is the address of an 
unsigned longword that receives this aggregate type. If the aggregate is of type 
DDIF$_EOS (end of segment), aggregate-handle is 0. 


Depending on the conversion used, the get-aggregate routine either creates and 
populates the next document content aggregate (aggregate method of conversion) 
or it reads the next aggregate from the in-memory document (document method 
of conversion). In either case, the returned aggregate must not be part of a 
sequence, and the DDIF$_SEG_CONTENT item of a DDIF$_SEG aggregate must 
be empty; the content must be returned one aggregate at a time followed by a 
DDIF$_EOS (end of segment) aggregate. 


A front end should create aggregates on demand, rather than first creating the 
entire document in memory. However, if the entire document must be available 
in memory in order for the conversion to take place, the get-aggregate routine 
must use the PRUNE AGGREGATE routine to return the next content aggregate 
from the in-memory document. The PRUNE AGGREGATE routine removes the 
next sequential document content aggregate from an existing in-memory DDIF 
document and returns the aggregate identifier and type. 


Before creating any of the document content aggregates, the get-aggregate routine 
must first create the required aggregates. For document data, the required 
aggregates are DDIF$_DSC, DDIF$_DHD, and DDIF$_SEG. For table data, the 
required aggregates are DTIF$_HDR, DTIF$_DSC, and DTIF$_TBL. Once these 
aggregates are created and the appropriate items have been stored (using the 
STORE ITEM routine), the get-aggregate routine creates and populates each 
sequential document content aggregate (and its subaggregates) that results from 
the translation of the input document. Once these aggregates are created and 
populated, the get-aggregate routine returns the handle and type of the parent 
aggregate. The aggregate type created must be a top-level content type, as listed 
in Table 11-1. 
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Table 11-1: Top-Level Aggregate Types 


Aggregate Type 
DDIF$_DSC 
DDIF$_DHD 
DDIF$_SEG 
DDIF$_TXT 
DDIF$_GTX 
DDIF$_HRD 
DDIF$_SFT 
DDIF$_HRV 
DDIF$_SFV 
DDIF$_BEZ 
DDIF$_LIN 
DDIF$_ARC 
DDIF$_FAS 
DDIF$_IMG 
DDIF$_CRF 
DDIF$_EXT 
DDIF$_PVT 
DDIF$_GLY 
DDIF$_EOS 
DTIF$_DSC 
DTIF$_HDR 
DTIF$_TBL 
DTIF$_ROW 
DTIF$_CLD 


Meaning 

Document descriptor 
Document header 
Document segment 
Text content 
General text content 
Hard directive 

Soft directive 

Hard value directive 
Soft value directive 
Bézier curve content 
Polyline content 

Arc content 

Fill area set content 
Image content 
Content reference 
External content 
Private content 
Layout galley 

End of segment 
Table descriptor 
Table header 

Table definition 
Table row 

Table cell 


The name of this routine is defined by the user. The front end simply returns the 
address of this routine to the CDA Converter Kernel. 


RETURN VALUES 


Return Value 
CDA$_ NORMAL 


CDA$_ENDOFDOC 


Description 
Normal successful completion 


End of document 


The get-aggregate routine can also return any front end-specific error conditions. 
Note that the get-aggregate routine must return the status CDA$_ENDOFDOC 
when the document has been completely transferred. 
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Get-Position Entry Point 


Returns the current position in and total size of the current data stream. The 
get-position routine is one of the routines that compose a front end. 


FORMAT 
status = get-position-procedure 
(front-end-handle ,stream-position ,stream-size) 


Argument Information 


Argument Argument Information 

status Usage: cond_value 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

front-end-handle Usage: identifier 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

stream-position Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 

stream-size Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: write only 
Mechanism: by reference 


RETURNS 
status 


A condition value indicating the return status of the routine call. 
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Description 


Get-Position Entry Point 


front-end-handle 

Identifier of the front end. The front-end-handle argument is the address of an 
unsigned longword that contains this handle. The front end handle is returned 
by either ddif$read_format or dtif$read_format. 


stream-position 

Receives the current position (in bytes) as measured from the start of the input 
stream being processed. The stream-position argument is the address of an 
unsigned longword that receives this position. 


stream-size 

Receives the total size (in bytes) of the input stream being processed. The 
stream-size argument is the address of an unsigned longword that receives this 
size. 


The get-position routine provides a method for a back end to determine the total 
size of the current input stream, as well as to determine the current position 
within the stream. This routine is useful for viewer back ends that provide a 
scroll bar indicating the current position in the document being viewed. 


The name of this routine is defined by the user. The front end simply returns the 
address of this routine to the CDA Converter Kernel. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 
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domain$read_ format Entry Point 


Initializes the conversion process and establishes any special processing informa- 
tion for the front end. The domain$read_format routine is one of the routines 


that compose a front end. 


FORMAT 


status = domain$read_format (standard-item-list ,converter-context 
,front-end-context 
,get-aggregate-procedure 
,get-position-procedure 
,close-procedure) 


Argument Information 


Argument 


status 


standard-item-list 


converter-context 


front-end-context 
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Argument Information 

Usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

Usage: item_list_2 

Data type: record 

Access: read only 
Mechanism: by reference,array reference 
Usage: context 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

Usage: context 

Data type: longword 

Access: write only 
Mechanism: by reference 


RETURNS 


Arguments 





Argument 
get-aggregate-procedure 


get-position-procedure 


close-procedure 


status 
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Argument Information 

Usage: procedure 

Data type: procedure entry mask 
Access: write only 
Mechanism: by reference 

Usage: procedure 

Data type: procedure entry mask 
Access: write only 
Mechanism: by reference 

Usage: procedure 

Data type: procedure entry mask 
Access: write only 
Mechanism: by reference 


A condition value indicating the return status of the routine call. 


standard-item-list 


An item list that identifies the document source and may also contain options to 
control processing. The standard-item-list argument is the address of this item 


list. 


Each entry in the item list is a 2-longword structure with the following format: 


buffer address 









To terminate the item list, you must specify the final entry or longword as zero. 
Valid code values for the items in the front end standard-item-list are as 


follows: 
¢ CDA$ INPUT_FILE 


The address and length of the file specification of the input document. 
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¢ CDA$ INPUT_DEFAULT 


The address and length of a string that specifies the default input file type. 
To simplify the porting of applications, the string should consist of only a file 
type in lowercase characters. If this parameter is omitted, the front end must 
supply an appropriate default file specification. 


¢ CDA$ INPUT_PROCEDURE 


The address of a user get procedure that provides input. The item list length 
field must be set to 0. The input procedure must conform to the requirements 
for a user get routine. For more information on the calling sequence for a 
user get routine, see the description of the Get entry point. 


¢ CDA$ INPUT_PROCEDURE_PARM 


The address of a longword parameter to the input procedure. The item list 
length field must be set to 4. 


¢ CDA$_INPUT_POSITION_PROCEDURE 


The parameter is the address of a procedure that provides position informa- 
tion. The item-list length field must be set to 0. For more information on the 
get-position procedure, see the description of the Get-Position entry point. 


¢ CDA$_PROCESSING_OPTION 


The address and length of a string that contains an option to control process- 
ing. The format name and leading spaces and tabs have been removed from 
the string. This item code may occur more than once in the item list. 


Either the CDA$_INPUT_FILE item or the CDA$_INPUT_PROCEDURE item, 
but not both, must occur once in the item list. If the CDA$_INPUT_PROCEDURE 
item is specified, then a single value for CDA$_INPUT_PROCEDURE_PARM can 
also be specified. 


NOTE 


If, in processing the standard item list, you encounter an unrecognized 
item, your front or back end should ignore that item and not return an 
error. 


converter-context 

Converter context required to call the OPEN CONVERTER routine. The 
converter-context argument is the address of an unsigned longword that 
contains this context. 


front-end-context 

Receives a front-end-defined value that identifies this particular instance of 

the front end. The front-end-context argument is the address of an unsigned 
longword that receives this context. This value is returned to the get-aggregate- 
procedure and the close-procedure arguments described later. All writable 
memory used by the front end must be allocated from dynamic memory and 
located by reference to this value. 
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Description 


domain$read_format Entry Point 


get-aggregate-procedure 

Receives the address of the get-aggregate routine. The get-aggregate-procedure 
argument receives the address of this procedure entry mask. For more informa- 
tion on the calling sequence for the get-aggregate routine, see the description of 
the Get-Aggregate entry point. 


get-position-procedure 

Receives the address of the get-position routine. The get-position-procedure 
argument receives the address of this procedure entry mask. For more informa- 
tion on the calling sequence for the get-position routine, see the description of the 
Get-Position entry point. 


close-procedure 

Receives the address of the close routine. The close-procedure argument 
receives the address of this procedure entry mask. For more information on the 
calling sequence for the close routine, see the description of the Close entry point. 


The read_format entry points (ddif$read_format and dtif$read_format) are 

the initial entry points in the front end. The read_format routine initializes the 
conversion process and establishes any special processing information for the 
front end. The term format in the entry point name refers to the name of the 
document format that is read by this particular front end. For example, the entry 
point for the Text front end is ddif$read_TEXT. 


On ULTRIX systems, front end and back end converters are invoked as subpro- 
cesses, rather than being dynamically loaded into the same address space, as 
they are on VMS systems. Because of this, on ULTRIX systems the entry point 
name for the read_format entry point is always the same, cda$read_format, no 
matter what the format name. This is usually accomplished in source code by 
using a “jacket” routine named cda$read_format that simply calls the real routine 
(ddif$read_format or dtif$read_format) with the same parameters (see the Text 
front end source code example in Chapter 12). Another way of accomplishing 
this is to use compiler directives (#ifdef in the C language) to name the function 
differently, depending on the operating system. 


In order to initialize a document or aggregate method of conversion, the 
ddif$read_format or dtif$read_format routine must first process the user- 
supplied item list, storing all pertinent information in the context block. 


The item list structure that is used to pass this information between the front 
end, back end, and the kernel is created by the CDA Converter Kernel; this 
structure contains the following fields: 


¢ cda$w_item_length specifies the length of the item. 


e cda$w_item_code specifies the item code, selected from the list specified for 
the standard-item-list argument. 


¢ cda$w_item_address specifies the address of the item. 


These fields are defined in the file cda$def.h on VMS systems and in the file 
cda_def.h on ULTRIX systems. 
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In addition, the ddif$read_format or dtif$read_format routine must process any 
specified processing options that the user selects for this conversion. 


If the format of the input file is not DDIF, DTIF, or Text, the front end must 
supply its own file-opening capability, typically through the use of the RMS 
$OPEN service, or the open C run-time library routine or equivalent language 
statement. 


It is also recommended that the ddif$read_format routine define values for at 
least the following aggregate items: 


¢ DDIF$_DSC_PRODUCT_IDENTIFIER specifies the registered facility 
mnemonic for the product that encoded the document. 


¢ DDIF$_DSC_PRODUCT_NAME specifies the name of the product that 
encoded the document. 


The ddif$read_format or dtif$read_format routine must call the CREATE ROOT 
AGGREGATE routine to create the document root aggregate. In the case of 
aggregate-method conversion, once the root aggregate is created, control passes 
back to the CDA Converter Kernel. 


In the case of document-method conversion, the read_format routine must 
also create the appropriate aggregates before reading the entire document from 
the input stream and placing it in memory. For document data, the required 
aggregates are DDIF$_DSC, DDIF$_DHD, and DDIF$_SEG. For table data, 
the required aggregates are DTIF$_HDR, DTIF$_DSC, and DTIF$_TBL. Once 
the entire document is in memory, the ddif$read_format or dtif$read_format 
routine must close the input stream (and, if applicable, the input file). Again, if 
the format of the input file is not DDIF, DTIF, or Text, the read_format routine 
must supply its own file-closing capability, typically through the use of the RMS 
$CLOSE service, or the close C run-time library routine or equivalent language 
statement. At this point, control passes back to the CDA Converter Kernel. 


RETURN VALUES 


Return Value Description 


CDA$_NORMAL Normal successful completion 


The read_format entry point can also return any front end-specific error condi- 
tions. 
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domain$write_format Entry Point 


Requests aggregates from the front end, converts them from the CDA in-memory 
format to the specified output format, and writes the information to the specified 
output file. The domain$write_format routine composes a back end. 


FORMAT 


status = domain$write_format (function-code ,standard-item-list 
,private-item-list ,front-end-handle 
,back-end-context) 


Argument Information 


Argument 


status 


function-code 


standard-item-list 


private-item-list 


front-end-handle 


Argument Information 

Usage: cond_value 

Data type: longword (unsigned) 
Access: write only 
Mechanism: by value 

Usage: longword_unsigned 
Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 

Usage: item_list_2 

Data type: record 

Access: read only 
Mechanism: by reference, array reference 
Usage: unspecified 

Data type: unspecified 

Access: read only 
Mechanism: by reference 

Usage: identifier 

Data type: longword (unsigned) 
Access: read only 
Mechanism: by reference 


CDA Converter Routines 11-15 


domain$write_format Entry Point 


RETURNS 


Argument Argument Information 

back-end-context Usage: context 
Data type: longword (unsigned) 
Access: read only or write only 
Mechanism: by reference 

Status 


A condition value indicating the return status of the routine call. 


function-code 

Symbolic constant that identifies the function to be performed. The function- 
code argument is the address of an unsigned longword that contains this 
symbolic constant. These constant values are defined in file cda$def.h on VMS 
systems and in the file cda_def.h on ULTRIX systems. Valid values are as follows: 


e CDA$_START 


Start conversion. This function code must be specified to begin a document 
conversion. 


¢ CDA$ CONTINUE 


Continue a conversion that was suspended. This function code may only be 
specified if a previous call to either ddif$write_format or dtif$write_format 
returned the value CDA$_SUSPEND. If CDA$_SUSPEND is returned by a 
call to the write_format routine, either CDA$ CONTINUE or CDA$_STOP 
must be specified so that resources locked by the conversion may be released. 


e CDA$ STOP 


Discontinue a conversion that was suspended. This function code may only be 
specified if the previous call to the write_format routine returned the value 
CDA$_SUSPEND. 


If CDA$_SUSPEND is returned by a call to ddif$write_format or dtif$write_ 
format, either CDA$_STOP or CDA$_ CONTINUE must be specified so that 
resources locked by the conversion may be released. 


standard-item-list 

An item list that identifies the document destination and may also contain 
options to control processing. The standard-item-list argument is the address of 
this item list. 


Each entry in the item list is a 2-longword structure with the following format: 
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buffer address 





To terminate the item list you must specify the final entry or longword as zero. 
The standard-item-list argument is ignored when function-code is set to 
either CDA$ CONTINUE or CDA$ STOP. Valid code values for the items in the 
standard-item-list are as follows: 
¢ CDA$ OUTPUT_FILE 

The address and length of the file specification of the output document. 
¢ CDA$ OUTPUT_DEFAULT 


The address and length of the default file specification of the output docu- 
ment. If this parameter is omitted, the back end must supply an appropriate 
default file specification. 


¢ CDA$ OUTPUT_PROCEDURE 


The address of a procedure to receive output. The item list length field must 
be set to 0. The output procedure must conform to the requirements for a 
user put routine. For more information on the calling sequence for a user put 
routine, see the description of the Put routine. 


e CDA$_OUTPUT_PROCEDURE_PARM 


The address of a longword parameter to the output procedure. The item list 
length field must be set to 4. 


¢ CDA$ OUTPUT_PROCEDURE_BUFFER 
The address and length of the initial output buffer for the output procedure. 
¢ CDA$ PROCESSING_OPTION 


The address and length of a string that contains an option to control process- 
ing. The format name and leading spaces and tabs have been removed from 
the string. This item code may occur more than once in the item list. 


Hither CDA$_OUTPUT_FILE or CDA$_OUTPUT_PROCEDURE, but not both, 
must occur once in the item list. If the CDA$_OUTPUT_PROCEDURE item 
occurs, then the CDA$_OUTPUT_PROCEDURE_PARM item and the CDA$_ 
OUTPUT_PROCEDURE_BUFFER item may each occur once in the item list. 


NOTE 


If, in processing the standard item list, you encounter an unrecognized 
item, your front or back end should ignore that item and not return an 
error. 
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Description 


private-item-list 

A private item list that is passed directly to the back end. The private-item-list 
argument is the address of this private item list. The specification of this item list 
is the responsibility of the back end. Its purpose is to provide for direct two-way 
communication between the caller of the CONVERT routine and the back end. 


On ULTRIX systems, the CDA$_OUTPUT_BACK_END_PROCEDURE item must 
be specified at the CONVERT routine call for this parameter to be used. 


front-end-handle 

Identifier of the front end that will process the document content. The front- 
end-handle argument is the address of an unsigned longword that contains this 
front end handle. This handle is passed to either the CONVERT DOCUMENT 
routine or the CONVERT AGGREGATE routine. 


back-end-context 

When function-code is set to CDA$_START, this argument receives a value 
defined by the back end that identifies this particular instance of the back end. 
The back-end-context argument is the address of an unsigned longword that 
either receives or specifies the converter context. This value will be returned to 
ddif$write_format or dtif$write_format for the functions CDA$_CONTINUE and 
CDA$_STOP. If a back end returns CDA$_SUSPEND, all writable memory used 
by the back end must be allocated from dynamic memory and located by reference 
to this value. 


The write_format entry points (ddif$write_format and dtif$write_format) are 
the entry points in the back end. This routine requests aggregates from the 
front end, converts them from the CDA in-memory format to the specified output 
format, and writes the information to the specified output file. The term format 
in the entry point name refers to the name of the document format that is being 
written by this particular back end. For example, the entry point for the Text 
back end is ddif$write_TEXT. 


On ULTRIX sytems, front end and back end converters are invoked as subpro- 
cesses, rather than being dynamically loaded into the same address space, as 
they are on VMS systems. Because of this, on ULTRIX systems the entry point 
name for the write_format entry point is always the same, cda$write_format, no 
matter what the format name. This is usually accomplished in source code by 
using a “jacket” routine named cda$write_format that simply calls the real rou- 
tine (ddif$write_format or dtif$write_format) with the same parameters (see the 
Text front end source code example in Chapter 12). Another way of accomplishing 
this is to use compiler directives (#ifdef in the C language) to name the function 
differently depending on the operating system. 


In order for the back end to call through to the front end, two routines are 
provided: 


¢ The CONVERT DOCUMENT routine invokes the document-method conver- 
sion of an input file to the specified output format. 


11-18 CDA Converter Routines 


domain$write_format Entry Point 


¢ The CONVERT AGGREGATE routine invokes the aggregate-method conver- 
sion of an input file to the specified output format. 


The back end must use one of these routines to request the appropriate informa- 
tion from the front end. 


If the format of the output file is not DDIF, DTIF, or Text, the back end must 
supply its own file-creation capability, typically through the use of the creat C 
run-time library routine or equivalent language statement. 


In order to initialize a document-method conversion, the write_format routine 
must first process the user-supplied item list, storing all pertinent information in 
the context block. The item list structure that is used to pass this information 
between the front end, back end, and kernel is created in the CDA Converter 
Kernel; this structure contains the following fields: 


¢ cda$w_item_length specifies the length of the item. 


¢ cda$w_item_code specifies the item code, selected from the list specified in 
this section. 


¢ cda$w_item_address specifies the address of the item. 


These fields are defined in the file cda$def.h on VMS systems and in the file 
cda_def.h on ULTRIX systems. 


RETURN VALUES 


Return Value Description 

CDA$_NORMAL Normal successful completion. 
CDA$_SUSPEND Converter is suspended. 
CDA$_INVFUNCOD Invalid function code. 
CDA$_INVITMLST Invalid item list. 
CDA$_UNSUPFMT Unsupported document format. 


The write_format routine can also return any error returned by the specific front 
end or the specific back end. 
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Text Front End Source File 





/% 


This chapter contains the source code for the Text front end provided with the 
CDA Toolkit. This front end should be used as a sample when writing your own 
front or back ends. The Text front end reads in a standard text file and creates a 


DDIF in-memory document. 


In this chapter, the source code for the Text front end is divided into subsections. 
Where appropriate, the subsections are annotated with a list following each 


section explaining the annotations. 


The following callouts correspond to the callouts in the main module of the Text 


front end. 


@ All of these routines from the CDA Toolkit are used by the Text front end. 


@ These are the additional entry points in the Text front end. 


® This is the context block that is used to share information between the front 


end, the CDA Converter Kernel, and the back end. 


kbp 


kx 
kk 
*x* 
Kk 
Kk 
xk 
*K* 
Kk 
kk 
Kk 
xx 
kk 


xk 
ee 
xk 
KK 
** 
KK 
x* 
xk 
x* 
xk 
** 
KK 
*xx* 
xk 
RK 
*x* 
** 


kk-- 


xx / 


COPYRIGHT (c) 1987 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 
ALL RIGHTS RESERVED. 


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


FACILITY: 
Compound Document Converters 
ABSTRACT: 
This is a Text Converter Front End that reads a text input 


file (or stream), creates DDIF aggregates from this text, and 
passes each DDIF Aggregate back to the calling converter kernel. 
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/* 
** 
Kk 
** 


x / 


#ifdef vms 


#include <ddifS$def.h> 


INCLUDE FILES 


/* Contain 


S values of al DDIF$xxxx keywords */ 


#include <cda$def.h> /* Contains values of all CDA$xxxx keywords */ 
#include <cdaSmsg.h> /* CDA error messages */ 
#else 
#include <ddif_def.h> 
#include <cda_def.h> 
#include <cda_msg.h> 
#endif 
#ifdef vms /* Use VMS RMS to manipulate files */ 
#include <fab.h> /* Defines the file access block structure */ 
#include <rab.h> /* Defines the record access block structure */ 
#include <nam.h> /* Defines the name block structure */ 
#include <rmsdef.h> /* Defines the completion status codes that RMS returns 
* after every file- or record-processing operation */ 
/* NOTE: The previous 4 #include statements can be replaced with <rms.h> */ 
#include <descrip.h> /* Allows program to pass arguments by descriptor. 
* A descriptor is a structure that describes the 
* data type, size, and address of a data structure. */ 
#endif 


/* Declare routines used in the Toolkit */ 


extern unsigned long cda$open_text_file(); 
extern unsigned long cda$close_text_file(); 
extern unsigned long cda$read_text_file(); 
extern unsigned long cda$get_aggregate(); 

extern unsigned long cda$get_text_position(); 
extern unsigned long cda$create_root_aggregate(); 
extern unsigned long cda$delete_root_aggregate(); 
extern unsigned long cda$create_aggregate(); 
extern unsigned long cda$store_item(); 

unsigned long get_aggregate(); 2 ] 
unsigned long create_dsc(); 

unsigned long create_dhd(); 

unsigned long create_seg(); 

unsigned long create_txt(); 

unsigned long create_eos(); 

unsigned long look_ahead(); 

unsigned long create _dir(); 

unsigned long get_position(); 

unsigned long close_front_end(); 


/* Define literals for characters used */ 


#define HORIZONTAL TAB 9 
#define FORM_FEED 12 
#define DDIF_BUFFER_SIZE 2048 
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/* Front End Context structure (text context) 


The front end context contains all variables needed to keep track 


of a conversion in progress. Since the front end, back end, 


* 
* 
* converter kernel are re-entrant, it is possible to have several 
* conversions occurring simultaneously. A pointer to this structure 
* is passed back and forth between the front and back ends, so 

* 


and 


that the front end knows where it is in any particular conversion. 


struct text_cxt { 
unsigned long text_a_file handle; 
unsigned long text_a_root_aggregate_handle; 
unsigned long (*text_a_input_routine) (); 
unsigned long text_a_input_routine_ param; 
unsigned long (*text_a_position_routine) (); 
unsigned long text_a_position_param; 
unsigned long text_l1_ state; 
unsigned char *text_a_buffer_address; 
unsigned long text_l_buffer_length; 


unsigned char *text_a_local_buffer; 
unsigned char text_1_local_length; 
unsigned long text_1_ directive type; 
unsigned long text_1 directive_content; 
unsigned char text_a_title[32]; 
unsigned long. text_1 title_length; 
unsigned long text_b scope level; 
unsigned long text_l_ newline count; 


unsigned char text_v_end_of paragraph : 1; 
unsigned char text_v_root_segment 3: 1; 
unsigned char text_v_end_of_document : 1; 
unsigned char : 0; 
}; . 
/* Default file extension */ 
static unsigned char default _file[] = ".txt"; 
static unsigned long default_length = sizeof(default_file) - 1 
/* Name for Root Segment */ 
static unsigned char seg id[] = "RootSegment"; 


static unsigned long seg_id_ length = sizeof(seg id) - 1; 


/* Name for style guide file */ 
static unsigned char style guide_name[] = "defstyle"; 
static unsigned long 


/* Name for paragraph */ 


static unsigned char para_buffer[] = "PARA"; 

static unsigned long para_length = sizeof(para_buffer) - 1; 
/* Name for literal */ 

static unsigned char literal _buffer[{] = "LITERAL"; 


static unsigned long 


/* Name for erf descriptor */ 
static unsigned char erf_desc_type[] 
static unsigned long 


"Style Guide"; 


/* Name for erf label type */ 
static unsigned char erf label _type[] = "SSTYLE"; 
static unsigned long 


/* 


kk 
**x MACROS 


kk 
ax / 


/* Error check macros */ 


#define FAILURE (status) 
(((status) & 1) == 0) 


erf_length = sizeof(erf_label_type) - 1; 


(3) 


style length = sizeof(style guide name) - 1; 


literal_length = sizeof(literal buffer) - 1; 


erf_desc_length = sizeof(erf_desc_type) - 1; 
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#define SUCCESS (status) 


(((status) & 1) 


/* Memory allocation and deallocation */ 


#ifdef 
extern 
extern 
#else 

extern 
extern 
#endif 


vms 


unsigned long libSfree_vm(); 
unsigned long libS$get_vm(); 


char *malloc(); 


free (); 


/* Literals used in creation of aggregates */ 


static 
static 
static 
static 
static 
static 


/* 


* 


* character and holes positions. 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


Lookup table 


char 
long 
char 
long 
char 
long 


for DEC MCS character set. 
Standard 169. This table has the space character inserted in the control 
This ensures no such characters appear 


dsc_identifier[] 
dsc_id_length 
dsc_prod_name[] 
dsc_nam_length 
dhd_author[{] 
dhd_aut_length 


* in the DDIF TXT aggregates. 


ued on 


"DDIFS"; 
sizeof(dsc_identifier) - 1; 
"DDIF Text Front End"; 
sizeof(dsc_prod_name) ~ 1; 
"DDIF Text Front End"; 
sizeof(dhd_author) - 1; 


These values are taken from DEC 


aA 
static unsigned char lookup_buffer[256] = 
(32. ::22y. (B2,. 32p-- 32, 32> Ba5- BOs Bap. 92). 152). BIy. aan ee G2 182; 
B25. By. 3325. 82. 32). 32). 82), 282). “32,0 B2p- 884 S25 B2e° 32, -32,- 32, 
32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 
48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 
64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 
80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 
96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 
112.443, 114,915, 116,317, 118), 119, 120, 121,222; 123,124,125, 126, 32, 
92,...B2,- 82). BoP “Shp B27" Bln Gop. 82y- BAe. 782 yp Bey. Bk y. Bey 82s. 32% 
325: 32. 882). (32 y.. Ble. B2p: B2e: Be, 2-82). 32. S24. SA BSn- S2K S25. 3 2y 
32, 161, 162, 163, 32, 165, 32, 167, 168, 169, 170, 171, 32, 32, 32, 32, 
176, 177, 178, 179, 32, 181, 182, 183, 32, 185, 186, 187, 188, 189, 32, 191, 
192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 
208; (209;, 210,211, 212, 213). 214, 215, 216, 217, 218, 219, 2203. 221, 82,223, 
224,. 225, 226, 227, 228, 229,. 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 
240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 32, 32}; 

The following callout corresponds to the callout in the jacket entry point for the 

Text front end. 

@ This is a jacket routine that supports the ULTRIX entry point to the Text 

front end. 
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/* 
pp 
K* 
xk 
k* 
Kk 
Kk 
*k* 
K* 
xk 
k* 
xk 


xx 
xk 
x* 
** 
** 
xk 
ak 
xk 
xx 
** 
xK* 
Kk 
ke 
k* 


** 
*K* 
xx 
** 


xk 
*x* 
*x* 
K* 


** 
Kk 
xk 
** 
Kk 
kk 
** 
kk 
kk 
kk 
kk 
KK. 


x / 


FUNCTIONAL DESCRIPTION: 


The name of this routine is CDA$READ_ FORMAT (). 


4) 


This routine is the jacket entry point for the text Front End on 


Ultrix. It is called from the converter kernel to 


call the "real" entry point which initializes the conversion. 
When employed on VMS systems, this routine is not called (or even 


compiled). On VMS systems, the converter kernel calls the 


DDIFS$READ_TEXT() routine. 


FORMAL PARAMETERS: 


item_list.rr.ra item list 

cvt_context.rlu.v value for cda$Sopen_converter 
text_context.wlu.v value to identify this converter 
get_aggr.wa.r address of get aggregate routine 
get_pos.wa.r address of get position routine 
close _text.wa.r address of close front end routine 


IMPLICIT INPUTS: 


none 


IMPLICIT OUTPUTS: 


none 


FUNCTION VALUE: 
CDA$_NORMAL 
CDA$_INVAGGTYP 
Memory allocation error conditions 
File error conditions 


SIDE EFFECTS: 


none 


#ifdef ultrix 


unsi 


gned long cdaSread_format (item_list, 


cvtr_context, 
text_context_ptr, 


get_aggr, 
get_pos, 
close_text) 
struct item_list *item_ list; 
unsigned long evtr_context; 
unsigned long *text_context_ptr; 
unsigned long *get_aggr; 
unsigned long *get_pos; 
unsigned long *close_text; 
{ 
unsigned long ddifS$read_text(); 


} 


return (ddif$read_text (item_list, cvtr_context, 
get_aggr, get_pos, close text)); 


#endif 


text_context_ptr, 
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The following callouts correspond to the callouts in the main entry point of the 
Text front end. 


@ This is the main entry point of the Text front end. 


© This loop reads the items in the item list passed to the Text front end. This 
item list can contain information such as the file specification of the file to be 
used for input, the routine to be used to read the input, a parameter to the 
input routine, and so on. 


@ This statement creates the DDIF root aggegate (type DDIF$_DDF). This 
aggregate is required in every DDIF document. © 


© The next aggregate to be created is the document descriptor aggregate (type 
DDIF$_DSC). This aggregate is also required in every DDIF document. 


/* 
xR 

** FUNCTIONAL DESCRIPTION: 5) 
Kk 

is This routine is the entry point for the Text Front End. It 

iia is called from the converter kernel to initialize the 

Kx conversion. 


xk 


** GENERAL DESCRIPTION: 
kk 


ae The DDIFSREAD format entry point is the initial entry point in the 


stl front end. This routine initializes the conversion process and 

tastes establishes any special processing information for the front end. 
am The term "format" in the entry point name refers to the name of the 
saad document format that is read by this particular front end --- 

aK "TEXT", in this instance. 

kk 

ead This routine is required and must be named according to the above 
sd convention. Three other routines/entry points are also required. 

aia The parameters to this routine specify their addresses to the 

ae converter kernel. 


kk 


** FORMAL PARAMETERS: 


7“ item_list.rr.ra item list 

kk 

x cvt_context.rlu.v value for cdaSopen_converter 

** 

a text_context.wlu.v value to identify this converter 


xx The next three parameters are the addresses of the other required 
x* entry points in any front end. 


eK get_aggr.wa.r address of get aggregate routine 
k* 5 

ipa get_pos.wa.r address of get position routine 

kk 

its close_text.wa.r address of close front end routine 


** I JMPLICIT INPUTS: 
KR 


ae text file or data stream 
kK* 


** IMPLICIT OUTPUTS: 
ak 


tala none 
kk 


xx FUNCTION VALUE: 


xX 


wx CDA$_NORMAL 

wx CDA$_INVAGGTYP 

sah Memory allocation error conditions 
a File error conditions 


a 
** SIDE EFFECTS: 


K* 
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xx 
*x* 
ek 


xx / 


none 


unsigned long ddif$read_text (item_list, 


cvtr_context, 
text_context_ptr, 


get_aggr, 
get_pos, 
close _ text) 
struct item_list *xitem_list; 
unsigned long cvtr_context; 
unsigned long *text_context_ptr; 
unsigned long *get_aggr; 
unsigned long *get_pos; 
unsigned long *close_text; 
{ 
unsigned long status; /* return status */ 
unsigned long struct_size; /* holds context block size */ 
unsigned long aggregate_type; /* aggregate type*/ 
unsigned long result_length; /* result file length */ 
unsigned char result_buffer[255]; /* result file buffer */ 
unsigned long filespec_length; /* file specification length */ 


unsigned char *default_file address; 
unsigned long default_file length; 
unsigned char *input_file address; 
unsigned long input_file length; 


struct text_cxt *text_context; 


/* Allocate the context block for this front end */ 


struct_size = sizeof (struct text_cxt); 
text_context = 0; 

default_file address = default_file; 
default file length = default_length; 


input_file address = 0; 

input_file length = 0; 
#ifdef vms 

status = lib$get_vm(&struct_size, &text_context, 0); 
#telse 

text_context = (struct text_cxt *) malloc(struct_size); 

(text_context == 0) ? (status = CDA$_ALLOCFAIL) : (status 
#endif 


if (FAILURE (status) ) 
return (status); 


/* Initialize the context block */ 
text_context->text_a_file handle = 
text_context->text_a_root_aggregate_handle 
text_context->text_a_input_routine 
text_context->text_a_input_routine param 
text_context->text_a_position_routine 
text_context->text_a_position_param 
text_context->text_l_ state 
text_context->text_l_ title length = 
text_context->text_a_buffer address 7 


ll 


text_context->text_l buffer length = 
text_context->text_a_local_buffer 
text_context->text_l_local_length 
text_context~->text_l_ directive_type 
text_context->text_l directive content 
text_context->text_b_scope_level 
text_context->text_l newline count 
text_context—>text_v_root_segment 
text_context->text_v_end_of paragraph 
text_context->text_v_end_of_document 


oorcoocqc”cnooo ooqco0coco qo o 


Ne Ne Ne 


oi oil 
me Me Se Se Ne Ne Ne 


| 


Ne Ne Ne Ne Ne Ne Se Ny Ne 


/* points to context block */ 


= 1); 
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/* Scan item list until item code is 0 */ 
while (item_list->cda$w_item_code != 0) 6 
{ 

Status = 1; 

switch (item_list->cda$w_item_code) 


{ 


case CDA$_INPUT FILE: /* Input filename */ 
input_file length = item_list->cda$w_item_length; 
input_file_ address = (unsigned char *) 
item_list->cda$a_item_address; 
break; 
case CDA$ INPUT DEFAULT: /* Default input filename */ 


default_file length item_list->cda$w_item_length; 
default_file_ address = (unsigned char *) 

item_list->cda$a_item_address; 
break; 


case CDA$_INPUT_PROCEDURE: /* Input procedure address */ 
text_context->text_a_input_routine = 
(unsigned long (*) ()) 
item _list->cda$a_item_address; 
break; 


case CDA$ INPUT PROCEDURE PARM: /* Input procedure param */ 
text_context->text_a_input_routine param = 
*((unsigned long *) 
item_list->cda$a_item_address) ; 
break; 


case CDA$ INPUT POSITION PROCEDURE: /* Input position 
proc address */ 
text_context->text_a_position_routine = 
(unsigned long (*) ()) 
item_list->cda$a_item_address; 
break; 


default: /* All others */ 
break; 


} 


/* Any problems? */ 
if (FAILURE (status) ) 
return (status); 


/* Point to next item in item list x/ 
/* Note that this advances the item list a full two longwords */ 
/* (i.e. + 1 * sizeof (item _list)) *7/ 


item_list += 1; 


} 


/* Create a DDIF root aggregate */ 
aggregate type = DDIF$ DDF; @ 
status = cda$create_root_aggregate (0, 
t 

0, 

0, 

é&aggregate type, 

&text_context->text_a_root_aggregate_handle) ; 


/* I£ there is an error, return */ 
if (FAILURE (status) ) 
return (status); 


/* Try to open the input file if specified */ 
if (input_file_address != 0) 


result_length = sizeof (result_buffer); 


status = cda$open_text_file (&input_file length, 
input_file address, 
é&default file length, 
default_file address, 
éresult_length, 
result_buffer, 
éresult_length, 
&text_context->text_a file handle); 


12-8 Text Front End Source File 


#ifdef vms 

/* Parse filename from file specification 

* for use as the Title field in the Header 

¥/ 

if (SUCCESS (status) ) 

{ 
struct FAB fil_fab; /* File access block */ 
struct NAM fil_nam; /* Name block */ 
unsigned long esa_length = 255 /* file length */ 
unsigned char esa_buffer[255]; /* file buffer */ 


/* Initialize fab and nam blocks */ 
fil_fab = cc$rms_fab; 
fil_nam = cc$rms_nam; 


fil_fab.fab$l_dna = 0; 
fil_fab.fab$b_dns = 0; 
fil_fab.fab$l_fna = result_buffer; 
fil_fab.fabSb_fns = result_length; 
fil_fab.fab$l_nam = &fil_nam; 
fil_fab.fab$l1_fop = FAB$M_NAM; 


fil_nam.nam$b_nop = NAMS$M_SYNCHK; 
fil_nam.nam$l_rlf = 0; 
fil_nam.nam$l1_esa = esa_buffer; 
fil_nam.nam$b_ess = esa_length; 


/* Parse the file specification */ 
status = sys$parse(&fil_ fab); 
if (FAILURE (status) ) 

return (status); 


/* Copy the filename into the title area */ 
text_context->text_1l_title_length = fil_nam.nam$b_name; 
strncpy (text_context->text_a_title, 

fil_nam.nam$1l_name, 

fil_nam.nam$b_name) ; 


/* Copy the file extension into the title area */ 
strncpy (text_context->text_a_title + 
text_context->text_l_ title length, 
fil_nam.nam$l_type, 
fil_nam.nam$b_type) ; 
text_context->text_1 title length += fil_nam.nam$b_type; 


#endif 


/* If an input procedure was specified, set 
* the position parameter to the input parameter 
* otherwise, use the file handle. 


=i 
if (text_context->text_a_input_routine != 0) 
text_context->text_a_position_param = 
text_context->text_a_input_routine_ param; 
else 
text_context->text_a_position_param = 
text_context->text_a_file handle; 
/* 


* The state value tells the Get Aggregate routine what 
* aggregate to return next. In this case (first), we want 
* it to return a document descriptor. 
ed 
text_context->text_l_ state = DDIF$_DSC; 8 


/* Fill in -get and close procedure addresses */ 
*text_context_ptr = (unsigned long) text_context; 
*get_aggr (unsigned long) get_aggregate; 
*get_pos (unsigned long) get_position; 
*close_text (unsigned long) close_front_end; 


Hl 


/* How did we do? */ 
return status; 


Text Front End Source File 12~9 


The following callouts correspond to the callouts in the get_aggregate routine in 
the Text front end. 


© This routine reads the input data and calls the appropriate routines. 


® Before reading the input and creating the appropriate content aggregates, 
this routine creates a document descriptor (DDIF$_DSC) and document 
header (DDIF$_DHD) aggregate. These aggregates, along with the document 
root aggregate, are required in every DDIF document. 


The text_context->text_l1_state argument is used to specify the next 
aggregate to be created. After the DDIF$_DSC and DDIF$_DHD aggregates 
have been created, the state is set to DDIF$_SEG, so that the next aggregate 
created will be the root segment aggregate. 


i 


RR b+ 

** FUNCTIONAL DESCRIPTION: © 
Kk 

ax , This routine is the entry point for the ’get_aggregate’ procedure. 
Eel It reads an aggregate from the input DDIF stream and returns 

—_ this aggregate to the caller. 


K* 


** FORMAL PARAMETERS: 
ak 


OX text_context.wlu.v value to identify this converter instance 
*x* 

KK aggregate handle.wlu.r address to store aggregate handle 

RK ; 

oes aggregate_type.wlu.r address to store aggregate type 


** IMPLICIT INPUTS: 
xk none 
xx IMPLICIT OUTPUTS: 


xx none 


** FUNCTION VALUE: 


** CDAS$_NORMAL 

* CDA$_ENDOFDOC 

ex Memory allocation error conditions 
x* File error conditions 


** SIDE EFFECTS: 


aK none 
aK 


KK 
x / 
static unsigned long get_aggregate (text_context ptr, 
aggregate_handle, 
; aggregate _type) 
unsigned long *text_context_ptr; 


unsigned long *aggregate_ handle; 
unsigned long *xaggregate type; 


{ 
unsigned long status; 
struct text_cxt *text_context; 


/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 
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* The state value tells the Get Aggregate routine what aggregate 
* to return next. We will test the state value here to determine 
* what type of aggregate is needed. Each time an aggregate is 

* returned, the state value is set to return the next type of 

* aggregate. 


/* Find what DDIF aggregate we need to return */ 


switch (text_context-—>text_l_ state) 
{ 


/* Build a document descriptor */ 
case DDIF$_DSC: ® 


status = create_dsc (&text_context, 
aggregate type, 
aggregate_handle); 
break; 


/* Build a document header */ 
case DDIF$_DHD: 


status = create_dhd (&text_context, 
aggregate type, 
aggregate handle); 
break; 


/* Build a document segment */ 
case DDIF$ SEG: 


/* Create the SEG aggregate */ 

status = create seg (&text_context, 
aggregate type, 
aggregate_handle); 


break; 


/* Build a text aggregate */ 
case DDIF$ TXT: 


/* Create a TXT aggregate */ 

status = create _txt (&text_context, 
aggregate type, 
aggregate handle) ; 

break; 


/* Build a directive (new_line or new_page) */ 
case DDIF$_SFT: 
case DDIF$_HRD: 


/* Create a hard or soft directive aggregate */ 
status = create dir (&text_context, 
aggregate type, 
aggregate_handle) ; 
break; 


/* Build an end of segment */ 
case DDIF$ EOS: 


/* Create an end of segment aggregate */ 
status = create_eos (&text_context, 
aggregate type, 
aggregate_handle); 
break; 


/* If we got here it is surely an insidious bug */ 
default: 

status = CDA$_INTERR; 

break; 


} 


/* Return the status */ 
return status; 
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The following callout corresponds to the callout in the create_dsc routine in the 


Text front end. 


@ This routine creates and fills in the required DDIF$_DSC aggregate, sets the 
state to DDIF$ DHD, and returns to the switch statement referenced by ®. 


/* 
AK 


** FUNCTIONAL DESCRIPTION: 
aK 


** This routine creates a document descriptor aggregate and 


xe fills it in. 
a 


** FORMAL PARAMETERS: 


k* 

ae text_context.wlu.v value to identify this converter 
Kk 

** aggregate_type.wlu.r pointer to aggregate type 

kx 

ax aggregate _handle.wlu.r pointer to aggregate handle 


** 
** IMPLICIT INPUTS: 
xk 


altel none 
Kx 


** IMPLICIT OUTPUTS: 
aK 


kK none 
k* 


** FUNCTION VALUE: 


Kk 

** CDA$_NORMAL 

x Aggregate creation errors 

xx Memory deallocation error conditions 


xx 

xx SIDE EFFECTS: 
xk 

xk none 

K* 

KK ae 


xx f 


static unsigned long create _dse (text_context_ptr, 
aggregate type, 
aggregate handle) 


unsigned long 
unsigned long 
unsigned long 


{ 

unsigned long status; 

struct text_cxt *text_context; 
unsigned long aggregate item; 
unsigned long item_length; 
unsigned long item_index = 0; 
unsigned long add_info; 
unsigned long major_version; 
unsigned long minor version; 


*text_context_ptr; 
*aggregate type; 
*xaggregate_handle; 


/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Set the aggregate type */ 
*xaggregate_type = DDIF$_DSC; 


/* Create the aggregate */ 
status = cda$create_aggregate 


(&text_context->text_a_root_aggregate handle, 


aggregate type, 
aggregate_handle) ; 
if (FAILURE (status) ) 
return (status); 
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/* First item to include is the major version. */ 

major_version = DDIFSK_MAJOR_VERSION; 

item_length = sizeof(major_ version); 

aggregate item = DDIFS_DSC_MAJOR_VERSION ; 

status = cdaS$store item (&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
&aggregate item, 
é&item_length, 
émajor_version); 

if (FAILURE (status) ) 

return (status); 


/* The next item is the minor version */ 

minor version = DDIF$K_MINOR_VERSION; 

item_length = sizeof (minor version); 

aggregate _item = DDIF$_DSC_MINOR_VERSION ; 

status = cda$store_ item (&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
&aggregate_item, 
&item_length, 
&minor_ version); 

if (FAILURE (status) ) 

return (status); 


/* Now the product identifier */ 

aggregate item = DDIF$_DSC_PRODUCT_IDENTIFIER; 

status = cda$store item (&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
é&aggregate item, 
&dsc_id length, 
dsc_identifier); 

if (FAILURE (status) ) 

return (status); 


/* And the product name */ 
aggregate item = DDIFS_DSC_PRODUCT_NAME ; 
add_info = CDA$K_ISO_LATIN1; 
status = cda$store_ item (&text_context->text_a_root_aggregate_handle, 
aggregate handle, : 
&aggregate item, 
&dsc_nam_length, 
dsc_prod_name, 
&item_index, 
&add_info); 


/* Document header next */ 
text_context->text_l_ state= DDIF$_DHD; 


/* Say how we did */ 
return (status); 


The following callout corresponds to the callout in the create_dhd routine in the 
Text front end. 


® This routine creates and fills in the required DDIF$_DHD aggregate, sets the 
state to DDIF$_SEG, and returns to the switch statement referenced by @. 
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/* 
KK bp 
k* 
Kk 
kk 
k* 


FUNCTIONAL DESCRIPTION: 


This routine creates a document header aggregate and 


fills it in. 


xk 

**x FORMAL PARAMETERS: 

*w* 

ike text_context.wlu.v value to identify this converter 

*k 

ae aggregate _type.wlu.r pointer to aggregate type 

aK 

ba aggregate_handle.wlu.r pointer to aggregate handle 

xk 

x* IMPLICIT INPUTS: 

kk 

a none 

xk 

** IMPLICIT OUTPUTS: 

kk 

“* none 

xk 

** FUNCTION VALUE: 

xx 

isis CDA$_NORMAL 

iis Aggregate creation errors 

ies Memory deallocation error conditions 

*k* 

** SIDE EFFECTS: 

Kk 

ol none 

xk 

**k*-- 

xx / 

static unsigned long create dhd (text_context_ptr, 
aggregate type, 
aggregate handle) 

unsigned long *text_context_ptr; 

unsigned long *aggregate type; 

unsigned long *aggregate_ handle; 

{ 

unsigned long status; /* return status */ 

struct text_cxt *text_context; /* points to context block */ 

unsigned long aggregate_item; 

unsigned long item_index = 0; 

unsigned long int_length; 

unsigned long add_info; 

unsigned long erf_type; 

unsigned long erf_handle; 

unsigned char *erf aggregate; 

unsigned long object_identifier[7]; 


/* Dereference */ 
text_context (struct text_cxt *) *text_context_ptr; 


/* Set the aggregate type to document header. */ 
*xaggregate_ type = DDIF$_DHD; 
add_info = CDA$K_ISO_LATIN1; 


/* Create the aggregate */ 
status cda$create_aggregate 
(étext_context->text_a_root_aggregate_handle, 
aggregate type, 
aggregate handle); 
if (FAILURE (status) ) 
return (status); 
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/* Fill in the Author */ 
aggregate _ item = DDIF$ DHD AUTHOR; 
status = cda$store item (&text_context->text_a_root_aggregate_handle, 
aggregate handle, 
g&aggregate_item, 
édhd_aut_length, 
dhd_author, 
&item_index, 
&add_info); 


/* Fill in the Title if we have one */ 

if ((text_context->text_l_ title length != 0) && 
(SUCCESS (status) ) ) 

{ 


aggregate item = DDIF$_DHD_TITLE; 

status = cda$store_item 
(&étext_context->text_a_root_aggregate_handle, 
aggregate_handle, 
é&aggregate_item, 
&text_context->text_l_ title length, 
text_context->text_a_title, 
é&item_index, 
é&add_info) ; 


/* Create an external reference aggregate */ 
erf_type = DDIFS_ERF; 


/* Create the aggregate */ 
status cda$create_aggregate 
(&étext_context->text_a_root_aggregate_ handle, 
éerf_type, 
éerf handle); 
if (FAILURE (status) ) 
return (status); 


/* Store the object identifier of DDIF */ 


object_identifier[0] = 1; 
object_identifier[1] = 3; 
object_identifier[2] = 12; 
object_identifier[3] = 1011; 
object_identifier[4] = 1; 
object_identifier[5] = 3; 
object_identifier[6] = 1; 


aggregate_item DDIF$_ERF DATA TYPE; 
int_length = sizeof (object_identifier) ; 
status cda$store_ item (&text_context->text_a_root_aggregate_handle, 
&erf_ handle, 
é&aggregate_item, 
é&int_length, 
object_identifier) ; 


if (FAILURE (status) ) 
return (status); 


/* Store the style guide name */ 
aggregate item = DDIFS$ ERF_LABEL; 
add_info = CDA$K_ISO_LATIN1; 
status = cda$store_item (&text_context->text_a_root_aggregate_handle, 
éerf handle, 
&aggregate item, 
&style length, 
style guide name, 
&item_index, 
é&add_info); 


if (FAILURE (status) ) 
return (status); 
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/* Store the descriptor */ 

aggregate item = DDIF$ ERF DESCRIPTOR; 

add_info = CDASK_ISO_LATINI1; 

item_index = 0; 

status = cdaSstore item (&text_context->text_a_root_aggregate_ handle, 
éerf_handle, 
é&aggregate_item, 
é&erf desc_length, 
erf_desc_type, 
&item_ index, 
&add_info); 

if (FAILURE (status) ) 

return (status); 


/* Store the label type */ 

aggregate item = DDIF$ ERF_ LABEL TYPE; 

add_info = DDIFSK_STYLE_LABEL_ TYPE; 

status = cda$store_item (&text_context->text_a_root_aggregate_handle, 
é&erf handle, 
&aggregate item, 
éerf length, 
erf_ label _ type, 
&item_index, 
é&add_info); 

Lf (FAILURE (status) ) 

return (status) ; 


/* Store the copy info */ 

aggregate _item = DDIF$ ERF_CONTROL; 

int_length = sizeof(unsigned long); 

item_index = DDIF$K_NO_COPY_REFERENCE; 

status = cda$store item (&text_context->text_a_root_aggregate_handle, 
serf handle, 
&aggregate item, 
éint_length, 
&item_index) ; 

if (FAILURE (status) ) 

return (status); 


/* Store the Style Guide External Reference */ 

aggregate item = DDIF$_DHD_ EXTERNAL REFERENCES; 

int_length = sizeof(unsigned long); 

status = cdaSstore_item (&text_context->text_a_root_aggregate_handle, 
aggregate handle, 
&aggregate_item, 
&int_length, 
éerf handle); 

if (FAILURE (status) ) 

return (status); 


/* Fill in the Style Guide */ 
aggregate item = DDIF$ DHD STYLE GUIDE; 
item_index = 1; 
int_length = sizeof(unsigned long) ; 
status = cda$store_item (&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
&aggregate_ item, 
&int_length, 
&item_index) ; 


/* Segment next */ 
text_context->text_l_ state= DDIF$_SEG; 


/* Say how we did */ 
return status; 


The following callouts correspond to the callouts in the create_seg routine in the 
Text front end. 


® The first time this entry point is invoked, this routine creates the required 
document root segment and returns to the switch statement referenced by @ 
with the state still set to DDIF$_SEG. All subsequent calls to this routine 
create nested segments that contain the document content. 
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/* 
RES 
** 
kk 
kk 
k* 


Kk 
xk 
** 
*x* 
*xk 
Kk 
*K* 
xk 
*x* 
Kk 
Kk 
xk / 


@ If the root segment has just been created, this routine also creates a segment 
attributes aggregate (type DDIF$_SGA) and a type definition aggregate (type 
DDIF$_TYD) to define types that are accessible to all of the document content 
aggregates. Once these aggregates are created, this routine passes control 
back to the switch statement referenced by @. Because the state is still set to 
DDIF$_SEG, ® immediately passes control back to this routine to create the 


first nested segment of the document. 


® If this routine is not creating the root segment, it simply creates a nested 
segment aggregate and sets the state to DDIF$_TXT before passing control 


back to @. 


FUNCTIONAL DESCRIPTION: 


This routine creates a document segment aggregate and 


fills it in. 

FORMAL PARAMETERS: 
text_context.wlu.v 
aggregate _type.wlu.r 
aggregate handle.wlu.r 

IMPLICIT INPUTS: 
none 

IMPLICIT OUTPUTS: 


none 


FUNCTION VALUE: 
CDA$_NORMAL 
Aggregate creation errors 
Memory deallocation error conditions 


SIDE EFFECTS: 


none 


pointer to aggregate type 


static unsigned long 


create_seg (text_context_ptr, 


unsigned long 
unsigned long 
unsigned long 


{ 

unsigned long 
struct text_cxt 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 


aggregate type, 
aggregate_ handle) 


*text_context_ptr; 
*aggregate_type; 
*aggregate_handle; 


status; 
*text_context; 
aggregate item; 
item_length; 
item_index = 0; 
add_info; 
tyd_handle; 
tyd_ type; 
sga_handle; 
sga_type; 


/* Dereference */ 


text_context = (struct text_cxt *) *text_context_ptr; 


/* Set the aggregate type to segment */ 
*xaggregate type = DDIFS_ SEG; 


value to identify this converter 


pointer to aggregate handle 
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/* Create the root segment */ 
status = cda$create aggregate (&text_context->text_a_root_aggregate_handle, 
: aggregate type, 
aggregate_handle); 
if (FAILURE (status) ) 
return (status); 


/* If this is the root segment, then setup to create a */ 
/* child segment. */ 
if (text_context->text_v_root_segment == 1) ® 
{ 
/* Reset flags */ 
text _context-—>text_v_root_segment = 0; 


/* Store SEG ID in segment */ 
aggregate _ item = DDIF$ SEG ID; 
status = cda$store_ item 
(&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
éaggregate_item, 
é&seg_id_ length, 
seg_id); 
if (FAILURE (status) ) 
return (status); 


/* Create an attribute aggregate */ 

sga_type = DDIFS SGA; 

status = cda$create_aggregate 
(&text_context->text_a_root_aggregate_handle, 
&sga_type, 
&sga_handle) ; 

if (FAILURE (status) ) 

return (status); 


/* Store SGA in segment */ 
aggregate item = DDIF$_SEG SPECIFIC_ATTRIBUTES; 
item_length = sizeof (sga_handle); 
status = cda$store_item 
(&étext_context->text_a_root_aggregate_handle, 
aggregate handle, 
g&aggregate_item, 
&item_ length, 
&sga_handle) ; 
if (FAILURE (status) } 
return (status); 


/* Create a type definition aggregate */ 

tyd_type = DDIF$_TYD; 

status = cda$create_aggregate 
(&text_context->text_a_root_aggregate_handle, 
étyd_ type, 
étyd_handle) ; 

if (FAILURE (status) ) 

return (status); 


/* Store TYD in SGA */ 

aggregate_item = DDIF$_SGA_TYPE_DEFNS; 

item_length = sizeof (tyd_handle); 

status = cda$store_item 
(&text_context->text_a_root_aggregate_handle, 
&sga_handle, 
&aggregate_item, 
é&item_length, 
&tyd_handle); 

if (FAILURE (status) ) 

return (status); 
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else 


} 


/* Store TYD_LABEL in TYD */ 
aggregate item = DDIF$_TYD LABEL; 
status = cda$store item 
(&text_context->text_a_root_aggregate_handle, 
étyd_handle, 
&aggregate item, 
épara_ length, 
para_buffer); 
if (FAILURE (status) ) 
return (status); 


/* Store TYD_ PARENT in TYD */ 
aggregate_item = DDIF$_TYD_PARENT; 
status = cda$store item 
(&text_context->text_a_root_aggregate_handle, 
&tyd_handle, 
&aggregate_ item, 
é&literal_ length, 
literal_buffer); 
if (FAILURE (status) ) 
return (status); 


/* Not a root segment; tag as paragraph */ 
aggregate_item = DDIF$ SEG SEGMENT TYPE; ® 
status = cda$store item 
(&text_context->text_a_root_aggregate handle, 
aggregate_handle, 
é&aggregate_item, 
é&para_length, 
para_buffer); 
if (FAILURE (status) ) 
return (status); 


text_context->text_1_ state= DDIF$ TXT; 


/* Bump scope level */ 
text_context->text_b scope level += 1; 


/* Say how we did */ 
return status; 


e® ® 8©8 66 886 


© 


The following callouts correspond to the callouts in the create_txt routine in the 
Text front end. 


This routine creates and fills in a text content aggregate. 


If a user-supplied text file input procedure was specified in the item list, use 
that procedure. Otherwise, use the CDA Toolkit routine READ TEXT FILE. 


If we reached the end of the document, pass control back to @. 


This loop reads each character on the line of text. If a form-feed character is 
encountered, the ff_found flag is set. 


If a horizontal tab character is encountered, the ht_found flag is set. 


The characters are passed through a filter to ensure that there are no control 
characters. 


If write_length was not zero, there was text on the line, so a DDIF$_TXT 
aggregate is created and the text is stored in the aggregate. 


If a form-feed character was encountered (indicated by ff_found = 1), this 
corresponds to a DDIF hard directive. Therefore, the value of the directive is 
set to DDIF$K_DIR_NEW_PAGE and the state is set to DDIF$_HRD. 


If a tab character was encountered (indicated by ht_found = 1), this 
corresponds to a DDIF soft directive. Therefore, the value of the directive is 
set to DDIF$K_DIR_TAB and the state is set to DDIF$_SFT. 
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/* 
Kp 


® 


26) 


If the tab or form-feed directive was the first character encountered on 
the line, pass control to the create_dir entry point to create the necessary 
directive aggregate. 


If there was no form feed or horizontal tab directive on the line, this 
statement checks to see if the line was completely read or if there are more 
characters on the line to be processed. If the line has been completely read, 
the next aggregate to be created is a new line (DDIF$K_DIR_NEW_LINE) 
soft directive aggregate (type DDIF$_SFT). Otherwise, create another 
DDIF$_TXT aggregate because there is more text to read. 


If the line was empty, the next aggregate to be created is new line (DDIF$K_ 
DIR_NEW_LINE) soft directive aggregate (type DDIF$_SFT). If this is the 
case, the value of the directive is set to DDIF$K_DIR_NEW_LINE, the state 
is set to DDIF$_SFT, and the create_dir routine is invoked. 


** FUNCTIONAL DESCRIPTION: ® 


** 
x* 
Kk 


This routine creates a text aggregate and fills it in. 


** FORMAL PARAMETERS: 


Kk 


is text_context.wlu.v value to identify this converter 
ak 

a aggregate _type.wlu.r pointer to aggregate type 

x* : 

* aggregate _handle.wlu.r pointer to aggregate handle 


KK 


** IMPLICIT INPUTS: 


k* 


xk none 


xk 


xx IMPLICIT OUTPUTS: 


kk 


a* none 


** 


xx FUNCTION VALUE: 


K* 


bas CDA$_NORMAL 
eK Aggregate creation errors 
al Memory deallocation error conditions 


xk 


** SIDE EFFECTS: 


** 


ae none 

K* 

kk 

** / 

static unsigned long create txt (text_context_ptr, 
aggregate _ type, 
aggregate handle) 

unsigned long *text_context_ptr; 

unsigned long *aggregate_ type; 

unsigned long *xaggregate_handle; 

{ 

unsigned long status; 

struct text_cxt *text_context; 

unsigned long aggregate item; 

unsigned long item_index; 

unsigned long add_info; 

unsigned long write length; 

unsigned long ££ found; 

unsigned long ht_ found; 

unsigned long junk; 
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/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


write length = 0; 
ff_found = OE 
ht_found = 0; 
item_index = 0; 


/* Do we need to get a line of text from the text file? */ 
if (text_context->text_l_ buffer_length == 0) 
{ 


/* File or procedure? */ 
if (text_context->text_a_input_routine == 0) ® 
{ 


status = cda$read_text_file 
(&text_context->text_a_file_ handle, 
&text_context->text_l_ buffer length, 


&text_context->text_a_buffer_address) ; 


else 


(*text_context->text_a_input_routine) 
(text_context->text_a_input_routine_ param, 
&text_context->text_l_ buffer_length, 
&text_context->text_a_buffer_address) ; 


status 


} 


/* Check for ENDOFDOC. If found, then 
stack for later processing. */ 
if (status == CDA$_ENDOFDOC) 
{ 
text_context->text_v_end_of_document = 1; ® 


/* Create an end of segment aggregate */ 
status = create eos (&text_context, 
aggregate type, 
aggregate handle); 
/* Get out of here; no further processing in TXT */ 
return status; 


if (FAILURE (status) ) 
return (status); 
else 
text_context->text_l_ newline count += 1; 


} 


/* Allocate text buffer */ 
if (text_context->text_1l_local_length < text_context->text_l1_buffer_length) 
{ : 

/* Deallocate old one first */ 

if text_context->text_l_ local_length > 0) 


#ifdef vms 
lib$free_vm(&text_context->text_1_ local_length, 
&text_context->text_a_local_ buffer, 0); 
#else 
free (text_context->text_a_local_buffer) ; 
#endif 
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/* Allocate larger buffer */ 

if (DDIF_BUFFER_SIZE > text_context->text_l_buffer_length) 
text_context->text_1]1 local_length = DDIF BUFFER_SIZE; 

else 
text_context->text_l1_local_length = 
text_context~->text_1_ buffer_length; 


#ifdef vms 
status = lib$get_vm(&text_context->text_l_local_length, 
&text_context->text_a_local_buffer, 0); 
#else 
text_context->text_a_local buffer = (unsigned char *) 
malloc (text_context->text_l local _ length); 
(text_context->text_a_local_buffer == 0) ? 
(status = CDA$_ALLOCFAIL) : (status = 1); 
#endif 


if (FAILURE (status) ) 
return (status); 


/* Were there characters on the line? */ 

if (text_context->text_l buffer length != 0) 

{ 
while (write_length < text_context->text_l_ buffer_length) ® 
{ 


/* Look for the Form Feed character (12) which is translated to 
* a new_page soft directive 


mY. 
if (text_context->text_a_buffer_address[write_length] 
== FORM FEED) 
{ 
ff_ found = 1; 
break; 
} 
else 


if (text_context~>text_a buffer _address[write_ length] 


== HORIZONTAL TAB) @ 
{ 
ht_found = 1; 
break; 


} 


else 
{ 
/* Make sure no control characters 
* pass through */ @ 
text_context->text_a_local_buffer[write_length] 
= lookup buffer 
(text_context->text_a_buffer_address[write length] ]; 


write_length += 1; 


/* Is there anything to write? May not be if 
FF is first on line */ 
if (write_length != 0) @ 
{ 
/* There was text on the line so 
we set the aggregate type to text */ 
*aggregate_type = DDIF$_TXT; 


status = cda$create_aggregate 
(&étext_context~>text_a_root_aggregate_handle, 
aggregate type, 
aggregate_handle) ; 
if (FAILURE (status) ) 
return (status); 
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/* We now store the text. line as a text content item */ 
aggregate_item = DDIF$ TXT_CONTENT; 
add_info = CDASK_ISO_LATIN1; 
status = cda$store item 
(&text_context->text_a_root_aggregate_handle, 
aggregate_handle, 
&aggregate item, 
éwrite_ length, 
text_context->text_a_local_ buffer, 
&item_index, 
g&add_info); 
if (FAILURE (status) ) 
return (status); 


/* Adjust buffer count and address for next pass */ 
text_context->text_l_ buffer length -= write _length; 
text_context->text_a_buffer_address += write _length; 


/* Special case for FORM_FEED or HORIZONTAL_TAB characters; 
skip over it */ 
if ((ff_found == 1) || 
(ht_found == 1)) 
{ 
text_context->text_l buffer length -= 1; 
text_context->text_a_buffer_address += 1; 


/* Setup for directive */ 
if (££ found == 1) ® 
{ 
text_context->text_1 directive_content = 
: DDIF$K_DIR_NEW_PAGE; 


text_context->text_l_ state = 
DDIFS_HRD; 

text_context->text_l_directive_type = 
DDIF$_HRD; 


else | @ 


text_context->text_l directive_content = 
DDIF$K_DIR_TAB; 

text_context->text_l_ state = DDIF$_SFT; 

text_context->text_l_ directive_type = DDIF$_ SFT; 


/* Create a directive aggregate if it is 


first on line */ @ 
L£ (write length == 0) 
{ 
status = create dir (&text_context, 
aggregate type, 
aggregate handle); 


} 


/* Finished with the line? */ @ 
else 


if (text_context->text_l_buffer_length == 0) 
{ 
/* Set next aggregate as new_line directive */ 
text_context~->text_l_ directive content = 
DDIF$K_DIR_NEW_ LINE; 
text_context->text_l_ state = DDIFS$_SFT; 
text_context->text_l_directive_type = DDIF$_SFT; 


else 
/* Otherwise, next aggregate is TXT */ 
text_context->text_l_state= DDIF$_TXT; 
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/* Empty line */ @ 
else 
{ 

/* Set directive to be new line */ 

text_context->text_l directive_content = DDIF$K_DIR_NEW_LINE; 
text_context->text_1 directive type = DDIFS$_ SFT; 


/* Create a directive aggregate */ 
status = create dir (&text_context, 
aggregate type, 
aggregate handle); 
} 


/* Say how we did */ 
return status; 


The following callouts correspond to the callouts in the create_eos routine in the 
Text front end. 


@® This routine creates an end-of-segment (type DDIF$_EOS) aggregate. This 
aggregate is a “dummy” aggregate in that it is not actually stored in the 
DDIF document. Instead, it is used to indicate the end of a segment. 


@ Ifthe front end has reached the end of the document and if the scope level 
is greater than or equal to 1 (the scope level indicates the level of nesting of 
segments), the previous DDIF$_EOS aggregate completed a nested segment 
and there are more segments to be completed before the document itself can 
be completed. In this case, the routine must continue to create DDIF$_EOS 
aggregates until the scope level is 0, meaning that the end of the root 
segment has been reached. At that point, the status CDA$_ENDOFDOC can 
be returned. 


@ Ifthe front end has not reached the end of the document, this routine only 
creates one DDIF$_EOS aggregate to complete the current nested segment. 
In this case, the state is set to DDIF$_SEG so that the next aggregate created 
is another nested segment. 


@ This statement decrements the scope level to indicate that a nested segment 
has been completed by a DDIF$_EOS aggregate. 


/* 
Ln oo 

xx FUNCTIONAL DESCRIPTION: @ 
x* 

ak This routine creates an end of segment aggregate 


aK 
**x FORMAL PARAMETERS: 


** 


wm text_context.wlu.v value to identify this converter 
kk 

islial aggregate _type.wlu.r pointer to aggregate type 

kk 

ae aggregate_handle.wlhu.r pointer to aggregate handle 


x 
xx IMPLICIT INPUTS: 
kk 


** none 
kK 


x* IMPLICIT OUTPUTS: 
** 


xx none 
x* 


** FUNCTION VALUE: 
a 


x* CDA$_NORMAL 
ike Aggregate creation errors 
~e Memory deallocation error conditions 


*x* 


** SIDE EFFECTS: 


*x* 
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xk none 
kx* 


kk 


** / 

static unsigned long create eos (text_context_ptr, 
aggregate _ type, 
aggregate handle) 

unsigned long *text_context_ptr; 

unsigned long *aggregate_type; 

unsigned long *aggregate_handle; 


{ 
unsigned long status; 
struct text_cxt *text_context; 


/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Return EOS as current aggregate */ 
*aggregate_ type = DDIF$_EOS; 
*aggregate handle = 0; 


/* If end of document, then set status */ 
if (text_context->text_v_end_of_document == 1) 
{ 
if (text_context->text_b scope level >= 1) @ 
{ 
/* Set next directive to be EOS for content */ 
text_context->text_l_ state= DDIFS_EOS; 


/* Set status to success */ 
status = CDA$_NORMAL; 


else 
/* Set status to end of document */ 
status = CDAS ENDOFDOC; 
} 
else 
{ $ 
/* Set state to be SEG*/ @ 


text_context->text_1_state= DDIFS$_SEG; 


/* Set status to success */ 
status = CDA$_NORMAL; 
} 


/* Decrement scope level */ 
text_context->text_b_ scope level -= 1; @ 


return (status); 


The following callout corresponds to the callout in the look_ahead routine in the 
Text front end. 


@ This routine is called by the create_dir routine to scan through multiple blank 
lines in the text file. 
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/* 
aR 
*x* 
k* 


kk 

HK ee 
x / 
stat 


unsi 


{ 
unsi 


FUNCTIONAL DESCRIPTION: @ 
This routine looks ahead for multiple blank lines in the text stream. 
Multiple blank lines indicate end of paragraph. They become 
hard newline directives. 


FORMAL PARAMETERS: 


text_context.wlu.v value to identify this converter 
aggregate type.wlu.r pointer to aggregate type 
aggregate handle.wlu.r pointer to aggregate handle 


IMPLICIT INPUTS: 


none 


IMPLICIT OUTPUTS: 
none 
FUNCTION VALUE: 
CDA$_NORMAL 
Aggregate creation errors 


Memory deallocation error conditions 


SIDE EFFECTS: 


none 
ic unsigned long look ahead (text_context_ptr) 
gned long *text_context_ptr; 


gned long status = 1; 


struct text_cxt *text_context; 


/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Look ahead and compress blank lines */ 
while ((text_context->text_l_ buffer length == 0) & 
(SUCCESS (status) )) 


/* File or procedure? */ 
if (text_context->text_a_input_routine == 0) 
{ 
status = cda$read_text_file 
(&text_context->text_a_file handle, 
&text_context->text_l buffer length, 
&text_context->text_a_buffer_ address) ; 


else 


status = (*text_context->text_a_input_routine) 
(text_context->text_a_input_routine_param, 
&text_context-—>text_1 buffer length, 
&text_context->text_a_buffer_address) ; 
} 
if (SUCCESS (status) ) 
text_context->text_1_ newline count += 1; 
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/* 
AR b+ 
Kk 
** 
xk 
kk 
k* 
kk 
k* 
kk 
xk 
xk 
** 
k* 
xk 
k* 
kk 
** 
K* 
Kk 
*K* 
kK* 
xk 


kk 
kK* 
kK* 
kk 
Kk 
xx 
kx* 
kk 
kk 
kk 
Kk mw 
xk / 
stat 


unsi 
unsi 
unsi 


{ 

unsi 
stru 
unsi 
unsi 


/* Check for ENDOFDOC. If found, then stack for later processing. */ 


if (status == CDAS ENDOFDOC) 


{ 


text_context-—>text_v_end_of document 
status = CDA$ NORMAL; 


} 


return status; 


The following callouts correspond to the callouts in the create_dir routine in the 


Text front end. 


@® If the directive content was set to DDIF$K_DIR_NEW_LINE (regardless of 
whether it indicates the end of a paragraph or the end of the document), this 
directive must be stored as a hard directive in a DDIF$_HRD aggregate. 


@ Otherwise, the appropriate type of aggregate is created and filled in. 


@ Ifthe directive was a new-line directive, the new-line counter is decremented 
and the routine checks to see if it is at the end of a paragraph, the end of the 
document, or if there are more new lines to process. The appropriate values 


are specified according to which case applies. 


FUNCTIONAL DESCRIPTION: 


This routine creates a directive aggregate and 


fills it in. 

FORMAL PARAMETERS: 
text_context.wlu.v 
aggregate _type.wlu.r 
aggregate handle.wlu.r 

IMPLICIT INPUTS: 
none 

IMPLICIT OUTPUTS: 


none 


FUNCTION VALUE: 


CDA$_NORMAL 
Aggregate creation errors 


Memory deallocation error conditions 


SIDE EFFECTS: 


ic unsigned long create dir (text_context_ptr, 
aggregate type, 
aggregate_handle) 


none 
gned long *text_context_ptr; 
gned long *aggregate type; 
gned long *aggregate_handle; 


gned long status; 

ct text_cxt *text_context; 
gned long aggregate item; 
gned long item_length; 


value to identify this converter 
pointer to aggregate type 


pointer to aggregate handle 
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/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Look ahead for blank lines? */ 

if ((text_context->text_l newline count == 1) && 
(text_context->text_v_end_of paragraph == 0) && 
(text_context->text_l buffer_length == 0)) 


status = look_ahead (&text_context); 
if (FAILURE (status) ) 
return (status); 


/* Is this a new line? */ ® 
if (text_context->text_l_ directive_content == DDIF$K_DIR_NEW_LINE) 


/* End of paragraph? (current newline plus at least 2 more) */ 
if (text_context->text_l newline_count > 2) 
text_context->text_v_end_of_paragraph = 1; 


/* Set HRD directive if end of paragraph or document */ 
if (text_context->text_v_end_of_paragraph == 1) 
text_context->text_l_ directive _type = DDIF$_HRD; 


if ((text_context->text_v_end_of document == 1) && 
(text_context->text_l_newline_ count == 1)) 
text_context->text_l_directive_type = DDIFS$ HRD; 


/* We are to return a directive */ 
*aggregate type = text_context->text_l_ directive _type; 


/* Create the aggregate */ @ 
status = cda$create_aggregate 
(&text_context->text_a_root_aggregate_handle, 
aggregate_type, 
aggregate handle); 
if (FAILURE (status) ) 
return (status); 


/* Set the directive type */ 

if (text_context->text_l directive_type == DDIF$_SFT) 
aggregate_item = DDIF$_ SFT DIRECTIVE; 

else 
aggregate_item = DDIF$_HRD_ DIRECTIVE; 


/* Store it */ 

item_length = sizeof (text_context->text_l_directive_content) ; 

status = cda$store item (&text_context->text_a_root_aggregate_handle, 
aggregate _handle, 
&aggregate item, 
&item_length, 
&text_context->text_l directive content) ; 

if (FAILURE (status) ) 

return (status); 


/* If this is a new line directive, then decrement counter */ @ 
if (text_context->text_l_directive_content == DDIF$K_DIR_NEW_LINE) 
text_context->text_l newline count -= 1; 
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/* Decide what aggregate to process next */ 
/* End of Document? */ 
if (text_context->text_v_end_of document == 1) 


{ 


/* Soft newlines to end of document */ 

if (text_context->text_l newline count >= 1) 

{ 
text_context->text_l state = DDIF$_HRD; 
text_context->text_l_ directive type = DDIF$_HRD; 
text_context->text_l_ directive_content = DDIF$K_DIR_NEW_LINE; 

} 

else 
/* EOS terminates paragraph and document */ 
text_context->text_l_state= DDIF$_EOS; 

} 


else 
/* End of Paragraph? */ 
if (text_context->text_v_end_of paragraph == 1) 
{ 
/* Hard newlines to end of paragraph */ 
if (text_context->text_1 newline_count >= 2) 
{ 
text_context->text_l_ state = DDIF$_HRD; 
text_context->text_l_ directive_type = DDIFS$_HRD; 
text_context->text_1l1_ directive_content = DDIF$K_DIR_NEW_LINE; 
} 


else 
/* EOS terminates paragraph */ 


{ 
text_context->text_l_ state= DDIF$_EOS; 
text_context~->text_v_end_of paragraph = 0; 


} 

else 
/* Not end of paragraph or document, but more newlines */ 
if (text_context->text_l_ newline count > 1) 


{ 


text_context->text_l state= DDIF$_SFT; 

text_context-—>text_l1_directive_type = DDIF$_SFT; 

text_context->text_l_directive_content = DDIF$K_DIR_NEW_LINE; 
} 


/* No more newlines; just text */ 
else 
text_context->text_1] state= DDIF$_TXT; 


/* Say how we did */ 
return status; 


The following callout corresponds to the callout in the get-position routine in the 
Text front end. 


© This routine determines the current location of the front end within the input 
stream. This routine is used primarily by viewer applications for scroll bar 
support. 
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/* 


aK b+ 

**x FUNCTIONAL DESCRIPTION: © 
xk f 

Kk This routine is the entry point for the ‘’get_position’ procedure. 
balked It returns the total size of the text stream and the current 

ak position (or offset) within the text stream. 


k* 


** FORMAL PARAMETERS: 


kk 
k* 
** 
k* 
*x* 
** 
xk 


text_context.wlu.v value to identify this converter instance 
stream position.wlu.r address to store stream position 


stream_size.wlu.r address to store stream size 


** IMPLICIT INPUTS: 


kk 
Kk 
*x* 


none 


xx IMPLICIT OUTPUTS: 


kk 
*k* 
xk 


none 


** FUNCTION VALUE: 


*x* 
xk 
kk 
** 
** 
k* 


CDA$_NORMAL 

CDA$_ENDOFDOC 

Memory allocation error conditions 
File error conditions 


xx SIDE EFFECTS: 


k* 


sit none 

Kk 

kk 

** / 

static unsigned long get_position (text_context_ptr, 
stream position, 
stream_size) 

unsigned long *text_context_ptr; 

unsigned long *stream_position; 

unsigned long *stream_size; 


{ 


unsigned long status; 
struct text_cxt *text_context; 
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/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Do we have a user supplied position routine? */ 
if (text_context->text_a_position_routine == 0) 
/* Ask the CDA Toolkit for the position and size information */ 
status = cda$get_text_position (&text_context->text_a_file handle, 
stream_position, 
stream size); 
else 
/* Ask user routine for position and size information */ 
status = (*text_context->text_a_position_routine) 
(text_context->text_a_position_param, 
stream_position, 
stream_size); 


return status; 


The following callout corresponds to the callout in the close routine in the Text 
front end. 


@ This routine closes the front end and deallocates all resources. 
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/* 
ab 
xk 
Kk 
Kk 
xk 
Kk 
k* 
** 
kK* 
kk 
k* 
kk 
*x* 
k* 
K* 
xk 
* 
kk 
ak 


Kk 
Kk 
Kk 
K* 
ak 
kk 
Kx 
Kk 
** 
Kk 
Kk 
** / 
stat 


unsi 


{ 
unsi 
unsi 


FUNCTIONAL DESCRIPTION: @ 
This routine is the entry point for the ’close front end’ procedure. 
It closes the input DDIF file (or stream) and deallocates the 
converter context. 

FORMAL PARAMETERS: 


text_context.wlu.v value to identify this converter 
IMPLICIT INPUTS: 

none 
IMPLICIT OUTPUTS: 


none 


FUNCTION VALUE: 
CDA$_NORMAL 
Memory deallocation error conditions 


File error conditions 


SIDE EFFECTS: 


none 

ic unsigned long close _front_end (text_context_ptr) 
gned long *text_context_ptr; 

gned long status; /* return status */ 

gned long struct_size; /* holds context block size */ 


struct text_cxt *text_context; /* points to context block */ 


/* Dereference */ 
text_context = (struct text_cxt *) *text_context_ptr; 


/* Do we have a file or just a stream? */ 
status = CDA$ NORMAL; 
if (text_context->text_a_file_handle != 0) 
{ 
/* Close the input file */ 
status = cda$close_text_file 
(&text_context->text_a_file_ handle); 
if (FAILURE (status) ) 
return (status); 


/* Delete the root aggregate */ 
status = cda$delete root_aggregate 
(&text_context->text_a_root_aggregate_handle); 


/* Deallocate text buffer and front end context block if we have one */ 
struct_size = sizeof (struct text_cxt); 


#ifdef vms 


if (text_context->text_l_ local_length > 0) 
lib$free vm(&text_context->text_l_ local_length, 
&text_context->text_a_local_ buffer, 0); 
libSfree_ vm (&struct_size, &text_context, 0); 


#else 
if (text_context->text_1_ local_length > 0) 
free (text_context->text_a_local_buffer); 
free (text_context) ; 
#endif | 


/* Say how we did */ 
return status; } 
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Chapter 13 


CDA Viewer Routines 





This chapter describes the VMS and ULTRIX compile and link procedures and 
routines used to write a viewer application. 


There are two sets of viewer routines: 1) the character cell viewer routines, which 
are listed first and which are preceded by DvrCC, and 2) the DECwindows viewer 
routines. Each routine description includes the following information: 


e An ULTRIX C style binding that is supported on both VMS and ULTRIX 
systems 


¢ A description of the value returned by the routine 
° A description of each routine argument 
e A description of the routine itself 


¢ A list of possible values returned by the routine 


13.1 CDA Viewer Support of Adobe Font Metrics 


The CDA Viewer uses the Adobe font metrics in processing a DDIF file for 
viewing. The font name in a DDIF file follows the X-11 font naming convention. 
When processing a file from a creating application that uses font metrics other 
than Adobe font metrics, the CDA Viewer defaults to the Adobe Courier font. 


The DECwindows CDA Viewer queries the X server for a list of available fonts 
when processing a file for viewing. Although the CDA Viewer does not use these 
fonts in its calculations, it tries to match the font from the file with an X11 font 
on the server. If there is not an exact match, the CDA Viewer uses the font 
from the list that is the closest lower point size for that font name. If there is 
no match at all, the DECwindows CDA Viewer display type defaults to 12 point 
Adobe Courier. 


The character cell CDA Viewer displays all files in a 12 point Courier font. The 
contents of each file are spaced and displayed correctly, based on the font that is 
stored in the file. 


The Adobe font metrics are stored in SYS$PS_FONT_METRICS:.AFM on VMS 
systems and in /usr/lib/font/metrics/ on ULTRIX systems. 
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13.2 Compile and Link Procedures for Viewer Images 


To create a VMS or ULTRIX program using the CDA Viewer callable interface, 
include the following public files in your source code: 


VMS and ULTRIX 

File Names Description 

SYS$LIBRARY:DVR$MSG.H Status codes for both the character cell viewer 

/usr/include/dvr_msg.h and the DECwindows viewer callable inter- 
faces. 

SYS$LIBRARY:DVR$CC_DEF.H Literals and structure definitions for the 

/usr/include/dvr_cc_def.h character cell viewer callable interface. 

SYS$LIBRARY:DVR$DECW_DEF.H Literals and structure definitions for the 

/usr/include/X11/dvr_decw_def.h DECwindows viewer callable interface. 


On ULTRIX systems, you must also install the DECimage Application Services 
libraries (libimg.a, libids.a, and libchf.a) before you can use the CDA DECwindows 
viewer callable interface library (libdvr.a) and the CDA character cell viewer 
callable interface library (libdvs.a). 


Section 13.2.1 describes the VMS compile and link procedure for CDA viewers. 
Section 13.2.2 describes the ULTRIX compile and link procedure for CDA viewers. 


13.2.1 VMS Link Procedure 


After you compile your source code into an object module (for example, YOUR_ 
MODULE.OBJ), link a C program (VIEWER_PROGRAM.EXE) using the 
following link command on VMS: 


$ LINK/EXE=VIEWER_PROGRAM YOUR_MODULE.OBJ, - 
SYSSINPUT/OPT 
SYSSSHARE : DDIFSVIEWSHR/ SHARE 


13.2.2 ULTRIX Link Procedures 


After you compile your source code into an object module (for example, your_ 
module.o), link a DECwindows viewer program (dw_viewer_program) using the 
following link command: 


csh> cc -o dw viewer program 
your module.o 


\ 

se) ‘\ 
/usr/lib/libdvr.a \ 
/usr/lib/libids.a \ 
/usr/lib/libdwt.a \ 
/usr/lib/libimg.a \ 
/usr/lib/libchf.a \ 
/usr/lib/libXli.a \ 
/usr/lib/libdvs.a \ 
\ 


/usr/lib/libddif.a 
/usr/lib/libm.a 


To link a character cell viewer program (cc_viewer_program), use the following 
command: 
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esh> cc -o cc_viewer program 
your _module.o 
/usr/lib/libdvs.a 
/usr/lib/libimg.a 
/usr/lib/libchf.a 
/usr/lib/libddif.a 
/usr/lib/libcurses.a 
/usr/lib/libtermlib.a 
/usr/lib/libm.a 


\ 
\ 
\ 
\ 
5 
\ 
‘ 
\ 


Applications that call the viewer routines should use a general condition handling 
routine for asynchronous signals that the viewer may generate. The signals 
probably will occur when the viewer is processing images, rather than text or 
graphics. The following example is a condition handling routine shell, written in 
C, which can be included in applications that call the viewer: 


int my _condition_handler(signal, mechanism) 
struct chf$signal array *signal; 
struct chf$mech_array *mechanism; 


{ 


/* signal->chf$l1_ sig name contains the error status; 
* process status and continue program execution 


as 
} 


In the main routine of your application, add the following call to set up the 
condition handler: 
#ifdef VMS 


LIBSESTABLISH (my_condition_handler) ; 
#fendif 


#ifdef ultrix 
ChfEstablish (my_condition_handler) ; 
#endif 


LIB$ESTABLISH() is a VMS run-time library routine. ChfEstablish() is the 
condition handling establish routine provided within libchf.a. 
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CC DELETE PAGE 


CC DELETE PAGE 


Deallocates the page display structure allocated by the routine CC GET PAGE. 


C FORMAT 
status = DvrCCDeletePage (cc_viewer_context, line_array) — 


Argument Information 


unsigned long *cc_viewer_ context; 
unsigned char Kee LING array; 


RETURNS 


status 
A condition value indicating the return status of the routine call. 


ARGUMENTS 


cc_viewer_context 
The address of an unsigned longword that specifies the CC viewer context. This 
value must be the value returned by the CC INITIALIZE routine. 


line_array 

The address of an unsigned longword that contains the address of the line array 
returned by the CC GET PAGE routine. This parameter serves to identify the 
line array and the corresponding line size array to be deallocated. 


Description 


The CC DELETE PAGE routine deallocates the page display structure allocated 
by the routine CC GET PAGE. Applications may delete this structure once it is 

no longer required. Page structures must be deallocated using the CC DELETE 
PAGE routine; applications cannot directly deallocate these structures. 
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CC DELETE PAGE 


RETURN VALUES 


Return Value Description 
DVR$_NORMAL Page successfully deleted 
DVR$_MEMDEALLOFAIL Memory deallocation failure 
CDA$_xxxx Any CDA return status 


CDA Viewer Routines 13-5 


CC END 


CC END 


Deallocates all internal structures that were allocated and does general cleanup 
required for CC viewer shutdown for the current file. 


C FORMAT 
status = DvrCCEnd (cc_viewer_context) 


Argument Information 


unsigned long *cc_viewer_ context; 


RETURNS 

status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 

cc_viewer_context 

The address of an unsigned longword that specifies the CC viewer context. This 

value must be the value returned by the CC INITIALIZE routine. 
Description 


The CC END routine deallocates all internal structures that were allocated and 
does general cleanup required for CC viewer shutdown for the current file. This 
routine may be called at any point during document processing. Any outstanding 
page structures not previously deleted by calls to the CC DELETE PAGE routine 
are also deallocated. 
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CC END 


RETURN VALUES 


Return Value Description 

DVR$_NORMAL Structures successfully deallocated 
DVR$_MEMDEALLOFAIL Memory deallocation failure 
CDA$_xxx Any CDA return status 
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CC GET PAGE 


CC GET PAGE 


Returns the next sequential formatted page from the CDA document. 


C FORMAT 
status = DvrCCGetPage 


(cc_viewer_context, number_of_lines, liné_array, 
line_size_array) 


Argument Information 


unsigned long *cc viewer context; 

unsigned long *number_ of lines; 

unsigned char wee Lane. array; 

unsigned long x*kline size array; 
RETURNS 

status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 


cc_viewer_context 
The address of an unsigned longword that specifies the CC viewer context. This 
value must be the value returned by the CC INITIALIZE routine. 


number_of_lines . 
The address of an unsigned longword that receives the number of lines in this 


page. 


line_array 
The address of an unsigned longword that receives the address of an array of 

_ longwords in which each element is the address of a null-terminated character 
string that represents the characters to be displayed on a line. Each element in 
the array represents a specific line number. Element 0 represents line 1, element 
1 represents line 2, and so on. 


line_size_array 

The address of an unsigned longword that receives the address of an array of 
longwords in which each element is the length of the character string for the 
corresponding line-array element. If you specify 0 by value for this parameter, no 
size array is returned. 
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CC GET PAGE 


Description 


The CC GET PAGE routine returns the next sequential formatted page from the 
CDA document. The page is returned as an array of character string pointers. 
Each character string represents a line of text. After the last page in the 
document has been processed, the CC GET PAGE routine returns a null page 
structure and the status DVR$_EOD (end of document). The page structures 
remain in memory until they are explicitly deleted by a call to either the CC 
DELETE PAGE routine or the CC END routine. 


RETURN VALUES 


Return Value Description 
DVR$_NORMAL Page returned successfully. 
DVR$_EOD The application is at the bottom of the file and cannot page 


forward any further. 


Any other error status codes. 
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CC INITIALIZE 


CC INITIALIZE 


Initializes the character-cell CDA Viewer and returns a context block to the caller 
for use in subsequent character-cell CDA Viewer routine calls. 


C FORMAT 
status = DvrCClnitialize 


(select_options, standard_item_list, 
private_item_list, display_height, display_width, 
cc_viewer_context) 


Argument Information 


unsigned long select_options; 

ITEM LIST TYPE *standard_item_list; 

ITEM LIST TYPE *private_item_list; 

unsigned long display height; 

unsigned long display width; 

unsigned long *cc_viewer context; 
RETURNS 

status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 


select_options 
A flag vector that may contain any of the following CDA Viewer masks: 


Mask Value Meaning 
DVR$M_Outfile Output is directed to a text file. If set, the entire 


document is written at once to the output file (or 
standard output) in the CC INITIALIZE routine 
without the application having to call the CC GET 
PAGE routine or the CC END routine. 


DVR$M_SoftDirectives Obey DDIF soft directives (new line, new page, and so 
on). 
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CC INITIALIZE 


Mask Value Meaning 
DVR$M_Auto_Wrap Output is word wrapped at the specified page width or 
galley width. 

DVR$M_Text Set to create text output. 

DVR$M_Graphics Set to note location of graphics in the output with a 
. replacement message. 

DVR$M_Images Set to note location of images in the output with a 

replacement message. 

DVR$M_Layout Use generic layout. 

DVR$M_SpecificLayout Use generic and specific layout. 

DVR$M_ReportErrors Write all nonfatal error messages to SYS$ERROR or 


stderr. Fatal errors are always reported. 
DVR$M_Paging If not set, the entire document is written at once to the 
output file (or standard output) in the CC INITIALIZE 
routine without the application having to call the CC 
GET PAGE routine or the CC END routine. 
DVR$M_Text_Backend If set, the CC viewer acts as a text back end. It 
expects the CDA front end handle to be passed in the 


private item list, with item code 
DVR$_FRONT_END_HANDLE. 


These masks are defined in DVR$CC_DEF.H. Note that if DVR$M_Text is not 
set, there will be no text output. = 


standard_item_list 
Address of a standard CDA item list. An item list contains entries consisting of 
two longwords. The item list is terminated by a null entry. 


The item codes are the same CDA$ item codes accepted by the CONVERT 
routine in its standard_item_list parameter. The CDA item codes are defined 
in SYS$LIBRARY:cda$def.* on VMS systems and in /usr/include/cda_def.h on 
ULTRIX systems. Item codes of the same names, but with the DVR$ prefix, are 
provided in SYS$LIBRARY:DVR$CC_DEF.H on VMS systems and in /usr/include 
/dvr_cc_def.h on ULTRIX systems. 


The CDA$_INPUT_PROCEDURE and CDA$_INPUT_ PROCEDURE_ 

PARM codes are supported. These allow the calling application to supply DDIF 
input rather than having the CDA Viewer get it from the specified input file. 
The standard item list actually supports all the items listed for the CONVERT 
routine, although not all item combinations make sense. 


private_item_list 

The address of a private item list, in the same format as the standard_item_ 
list. This item list only supports DVR$ item codes. Currently, the only item 
codes expected in this private item list are shown in the following table. 


Item Code Meaning 
DVR$_FRONT_END_HANDLE Front end input procedure handle 
DVR$_PAGE_HEIGHT Formatted page height in lines of characters 
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CC INITIALIZE 


Description 


Item Code Meaning 


DVR$_PAGE_WIDTH Formatted page width in columns of characters 


display_height 

The maximum height per page (in rows). If you specify 0 for this parameter, the 
resulting screen height is set to a size adequate to include the entire original 
page. This is useful for applications that would like the entire page formatted to 
a specific number of rows. 


display_width 
The maximum page width (in columns). If you specify 0 for this parameter, the 
resulting screen width defaults to 132 columns. 


cc_viewer_context 

The address of an unsigned longword that receives the CC viewer context. 
The address of this value must be specified as the cc_viewer_context input 
parameter during calls to the other CC routines. 


The CC INITIALIZE routine initializes the character-cell CDA Viewer and 
returns a context block to the caller for use in subsequent character-cell CDA 
Viewer routine calls. 


RETURN VALUES 


Return Value Description | 


DVR$_NORMAL CC viewer successfully initialized 


Any error status codes. 
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BOTTOM DOCUMENT 


BOTTOM DOCUMENT 


Displays the last page of content in the file in the widget window. 


C FORMAT 
status = DvrBottomDocument (w) 


Argument Information 


int status; 

Widget Ww; 
RETURNS 

Status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 

w 

Identifier of the CDA Viewer widget. 
Description 


When an application calls the BOTTOM DOCUMENT routine, the CDA Viewer 
displays the last page of content. 
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BOTTOM DOCUMENT 


RETURN VALUES 


Return Value 


DVR$_NORMAL 
DVR$_EOD 


DVR$_ERROR 


DVR$_INVADDR 
DVR$_FILENOTOPEN 
CDA$_xxxx 
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Description 
The last page of content was displayed successfully. 


The application is at the bottom of the file and cannot 
page forward any further. 


An error was encountered while reading the file, or 
converting to in-memory DDIF. 


Invalid address. 
There is no open file. 
Any CDA return status. 


CLOSE FILE 


CLOSE FILE 


Closes the file currently being read by the CDA Viewer and clears the window. 


C FORMAT 
status = DvrCloseFile (w) 


Argument Information 


int status; 

Widget W; 
RETURNS 

Status 


A condition value indicating the return status of the routine call. 


ARGUMENTS 


w 
The identifier of the CDA Viewer widget. 


Description 


The CLOSE FILE routine closes the file currently being read by the CDA Viewer 
and clears the window. 


RETURN VALUES 


Return Value Description 

DVR$_NORMAL The file was closed successfully. 
DVR$_FILENOTOPEN There is no open file. 
DVR$_INVADDR Invalid address. 

CDA$_xxxx Any CDA return status. 
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DOCUMENT INFO 


DOCUMENT INFO 


Returns information from the header aggregate of the currently open document. 


C FORMAT | 
status = DvrDocumentinfo _(w, buffer_dsc) 


Argument Information 


int status; 

Widget W; 

char **buffer_dsc; 
RETURNS 

status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 

w 

The identifier of the CDA Viewer widget. 

buffer_dsc 

The address of a string buffer to be allocated. 
Description 


The DOCUMENT INFO routine returns information from the header aggregate 
of the currently open document. This information includes the document title, 
author, version, and creation date. 
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RETURN VALUES 


Return Value 

DVR$_NORMAL 
DVR$_BADPARAM 
DVR$_FILENOTOPEN 
DVR$_DRMSTRINGFETCHFAIL 
DVR$_NODISPCONT 


DVR$_MEMDEALLOFAIL 
DVR$_MEMALLOFAIL 


DOCUMENT INFO 


Description 


The document’s header was successfully read. 
An invalid parameter was specified. 

There is no open file. 

Failure to fetch a string. 


The requested information is not contained in the 
document. 


Failure to deallocate memory. 


Failure to allocate memory. 
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GOTO PAGE 


GOTO PAGE 


Attempts to move to the specified page number. 


C FORMAT 
status = DvrGotoPage (w, page_num) 


Argument Information 


int status; 

Widget W; 

int page_num; 
RETURNS 

status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 

w 

Identifier of the CDA Viewer widget. 

page_num 

Page number of the desired page in the document. 
Description 


The GOTO PAGE routine attempts to move to the specified page number. 


RETURN VALUES 


Return Value Description . 
DVR$_NORMAL The CDA Viewer widget has successfully moved to the 


requested page. 


13-18 CDA Viewer Routines 


Return Value 


DVR$_EOD 
DVR$_PAGENOTFOUND 


DVR$_BADPARAM 


GOTO PAGE 


Description 


End of document. 


A page with the specified page number was not found 
in the document. 


An invalid parameter was specified. 
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NEXT PAGE 


NEXT PAGE 


Displays the next page of a CDA document. 


C FORMAT 
status = DvrNextPage (w) 


Argument Information 


int status; 

Widget Ww; 
RETURNS 

Status 

A condition value indicating the return status of the routine call. 
ARGUMENTS 

w 

Identifier of the CDA Viewer widget. 
Description 


The NEXT PAGE routine displays the next page of a CDA document. 


13-20 CDA Viewer Routines 


RETURN VALUES 


Return Value 
DVR$_NORMAL 


DVR$_INVADDR 
DVR$_EOD 
DVR$_FILENOTOPEN 
CDA$_xxxx 


NEXT PAGE 


Description 

The CDA Viewer widget has successfully moved to the 
next page. 

Invalid address. 

End of document. 

There is no open file. 


Any condition value returned by the CDA$ routines. 
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PREVIOUS PAGE 


PREVIOUS PAGE 


Displays the previous page (if one exists) of a CDA document. 


C FORMAT 


status = DvrPreviousPage (Ww) 


Argument Information 


int 


A condition value indicating the return status of the routine call. 


Widget 
RETURNS 

Status 
ARGUMENTS 


Ww 


Identifier of the CDA Viewer widget. 


Description 


The PREVIOUS PAGE routine displays the previous page (if one exists) of a CDA 


document. 


RETURN VALUES 


Return Value 
DVR$_NORMAL 


DVR$_INVADDR 
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Description 


The CDA Viewer widget has successfully displayed the 
previous page. 


Invalid address. 


Return Value 


DVR$_TOPOFDOC 


DVR$_FILENOTOPEN 
CDA$_xxxx 


PREVIOUS PAGE 


Description 


The application is at the top of the file and cannot page 
backward any further. 

There is no open file. 

Any condition value returned by the CDA$ routines. 
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REGISTER CLASS 


REGISTER CLASS 


Indicates that the CDA Viewer widget is registered with DRM. 


C FORMAT 


status = DvrRegisterClass () 


RETURNS 
status 


A condition value indicating the return status of the routine call. 


Description 


The REGISTER CLASS routine is used to indicate that the CDA Viewer widget is 
registered with DRM. This call is only necessary for developers using UIL. 


RETURN VALUES 


Return Value 


DVR$_NORMAL 
DVR$_INVADDR 
DVR$_FAILURE 


13-24 CDA Viewer Routines 


Description 
The CDA Viewer widget was successfully registered with DRM. 
Invalid address. 


The CDA Viewer widget was not successfully registered with 
DRM. 


TOP DOCUMENT 


TOP DOCUMENT 


Displays the beginning content of the file in the widget window. 


C FORMAT 
status = DvrTopDocument /(w) 


Argument Information 


int status; 
Widget Ww; 
RETURNS 
Status 
A condition value indicating the return status of the routine call. 
ARGUMENTS 
w 
The identifier of the CDA Viewer widget that opens and displays the information 
content of the file. 
Description 


The TOP DOCUMENT routine displays the beginning content of the file in the 
widget window. 


RETURN VALUES 


Return Value Description 

DVR$_NORMAL The beginning content was displayed successfully. 

DVR$_TOPOFDOC The application is at the top of the file and cannot page 
backward any further. 


CDA Viewer Routines 13-25 


TOP DOCUMENT 


Return Value 


DVR$_INVADDR 
DVR$_FILENOTOPEN 
CDA$_xxxx 
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Description 


Invalid address. 
There is no open file. 
Any CDA return status. 


VIEWER 


C FORMAT 


VIEWER 


Creates a widget for viewing a CDA file. 


Widget = DvrViewer 
(parent, name, x, y, width, height, horz_scroll_bar, 
vert_scroll_bar, proc_options, callback, 
help_callback) 


Argument Information 


RETURNS 


Widget parent; 

char *name; 

int x; 

int Ve 

int width; 

int height; 

Boolean horz_ scroll bar; 
Boolean vert_scroll_bar; 
int proc_options; 


DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 


Widget 
Identifier of the created CDA Viewer widget. 


ARGUMENTS 


parent 
The parent window of the widget. 


name 
The name of the widget to be created. 


XxX 

A signed longword that defines in pixels the placement of the left side of the 
widget window relative to the inner upper left corner of the parent window. The 
default is 0. 
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VIEWER 


y 

A signed longword that defines in pixels the placement of the left side of the 
widget window relative to the inner upper left corner of the parent window. The 
default is 0. 


width 
The width in pixels of the widget window. 


height 
The height in pixels of the widget window. 


horz_scroll_bar 
A Boolean value indicating that a horizontal scroll bar should be included in the 
CDA Viewer widget. 


vert_scroll_bar 
A Boolean value indicating that a vertical scroll bar should be included in the 
CDA Viewer widget. 


proc_options 

An integer mask indicating the options for processing the document. For a list 
of possible processing options masks, see the low-level creation routine VIEWER 
CREATE. 


callback 
The identifier of the application routine to be called back. The callback routine 
should have the form callback(Widget, tag, reason). ; 


help_callback 
The identifier of the application help routine to be called back. The callback 
routine should have the form callback(Widget, tag, reason). 


CALLBACK ROUTINES 


The format of the callback routines is as follows: 


void CallbackProc(WidgetID, tag, reason) 
Widget *WidgetID; 
caddr_t tag; 
DvrCallbackStruct *cb data; 


CALLBACK DATA STRUCTURE 


The format of the callback data structure is as follows: 


typedef struct 


{ int reason; 
Xevent *event; 
unsigned long status; 
char *string ptr; 


} DvrCallbackStruct; 
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VIEWER 


CALL BACK REASONS 


The application callback is called with the following values for reason: 


DvrCRactivated 
The CDA Viewer requests focus by clicking on MB1. 


DvrCRendDocument 
The end of the document has been displayed. 


DvrCRedaError 

A nonrecoverable error was incurred while processing the document. See the 
status field of the callback structure for the specific status returned. See the 
string-ptr field for a character string describing the status. 


DvrCRhelpRequested 
Help was requested by clicking on HELP + MB1. 


CALLBACK FIELD DESCRIPTIONS 


Description 


The callback field descriptions are as follows: 


reason 
See the Callback Reasons section. 


event 
A pointer to the X event structure describing the event that generated this 
callback. 


Status 
The specific status returned. 


string_ptr 
The character string describing the status. 


The VIEWER routine creates a widget that can be used to view the information 
content of an in-memory CDA document. If the document to be viewed is not 
in DDIF format, then a front end converter must exist that can convert the 
document from its non-DDIF format to in-memory DDIF. (A CDA Viewer widget 
can also be created using the low-level creation routine VIEWER CREATE.) 


To associate a file with the CDA Viewer widget, see the description of the 
VIEWER FILE routine. 
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VIEWER 


RETURN VALUES 


If the return value is successful, the VIEWER routine returns the ID of the 
widget. If the return value is failure, the VIEWER routine returns 0. 
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VIEWER CREATE 


VIEWER CREATE 


C FORMAT 


Creates a widget for viewing a CDA file. 


Widget = DvrViewerCreate 
(parent, name, override_arglist, override_argcount) 


Argument Information 


RETURNS 


Widget parent; 

char *name; 

ArgList override_arglist; 
int override argcount; 


Widget 
Identifier of the created CDA Viewer widget. 


ARGUMENTS 


parent 
The parent window of the widget. 


name 
The name of the widget to be created. 


override_arglist 

The application override argument list. This list consists of name/value pairs 
that describe the attributes of the created widget. For more information on 
the override_arglist argument, see the VMS DECwindows Toolkit Routines 
Reference Manual. 


The override_arglist argument can contain any of the common arguments for 
low-level widget creation routines, plus the following widget-specific arguments: 


¢ Boolean horz_scroll_bar 
¢ Boolean vert_scroll_bar 
* int processing_options 


¢ int paper_width 
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VIEWER CREATE 


¢ int paper_height 


override_argcount 

The number of arguments in the application override argument list. If there are 
no arguments in the argument list, then override_argcount must equal zero, 
but the override_arglist does not have to be null. In the VMS DECwindows 
Toolkit Routines Reference Manual, see the Common Arguments section for 
descriptions of the VAX and C formats of arguments common to all widgets. 


Widget Specific Attributes 


horz_scroll_bar 

Boolean argument that, if true, results in a horizontal scroll bar being placed at 
the bottom of the CDA Viewer widget window. The default value is true. The 
name of this argument is DvrNscrollHorizontal. This is a create time only 
resource and cannot be modified through XtSet Values. 


vert_scroll_bar 

Boolean argument that, if true, results in a vertical scroll bar being placed at the 
right side of the CDA Viewer widget window. The default value is true. The name 
of this argument is DvrNscrollVertical. This is a create time only resource and 
cannot be modified through XtSet Values. 


processing_options 

This argument is a mask formed by the union of processing options to be followed 
when document content is displayed in the CDA Viewer. The name of this 
argument is DvrNprocessingOptions. The supported processing options are 
shown in the following table. 


Processing Option Mask Value 
Word wrap DvrWordWrap 
Soft directives DvrSoftDirectives 
Layout DvrLayout 
Specific layout DvrSpecificLayout 


The default is: 
DvrWordWrap | DvrSoftDirectives | DvrLayout | DvrSpecificLayout 


paper_width 
Integer value that specifies the desired width of the paper in millimeters. The 
name of this argument is DvrNpaperWidth. 


This argument does not apply to the CDA Viewer’s window width; it applies 
only to the size of the paper to be used for each page displayed in the CDA 
Viewer’s window. By default, the CDA Viewer uses the paper width stored in 
the document. If this item is not encoded, the CDA Viewer uses a default paper 
width of 8.5 inches. 


paper_height 


Integer value that specifies the desired height of the paper in millimeters. The 
name of this argument is DvrNpaperHeight. 
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Description 


VIEWER CREATE 


This argument does not apply to the CDA Viewer’s window height; it applies 
only to the size of the paper to be used for each page displayed in the CDA 
Viewer’s window. By default, the CDA Viewer uses the paper height stored in 
the document. If this item is not encoded, the CDA Viewer uses a default paper 
height of 11 inches. 


The VIEWER CREATE routine is a low-level routine used to create a widget 

for viewing an in-memory DDIF file. If the file is not in DDIF, there must be a 
front end converter that can be called to corivert the file into in-memory DDIF. To 
associate a file with the CDA Viewer widget, see the description of the VIEWER 
FILE routine. A CDA Viewer widget can also be created using the high-level 
VIEWER creation routine. 


See the description of the high-level creation routine VIEWER for the definition 
of the callback structure and the reasons for a callback. 


Defaults: 

The default height is 723 pixels and the default width is 684 pixels. 

The default x,y location of the widget is the upper left corner of the parent. 

A CDA Viewer widget can also be created using the high-level VIEWER routine. 


RETURN VALUES 


If the return value is successful, the VIEWER CREATE routine returns the ID of 
the widget. If the return value is failure, the VIEWER CREATE routine 
returns 0. 
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VIEWER FILE 


VIEWER FILE 


Opens a file and begins to view the information content of the file, provided the 
file can be converted to in-memory DDIF. 


C FORMAT 
status = DvrViewerFile 


(w, filename, format, optionsfile, getrtn, getprm) 


Argument Information 


2k status; 

Widget W; 

char *filename; 

char *format; 

char *optionsfile; 

int getrtn; 

int getprm 
RETURNS 

Status 

The result of attempting to open and begin the conversion of the file. 
ARGUMENTS 


w 
The identifier of the CDA Viewer widget that should open and display the 
information content of the file. 


filename 
A character string specifying the name of the file to be viewed. 


format 

A character string specifying the format of the file to be viewed. If the file is not 
in DDIF format, a converter must exist that can convert the file to in-memory 
DDIF. 


optionstfile 


A character string specifying a file with processing options for the front end 
converter. If this argument is null, 0, or a zero-length string, it is not used. 
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VIEWER FILE 


getrin 

If the file should be read by other than the system default read routine, this 
argument should identify the alternative read routine. If the standard read 
routine is to be used, the value of getrtn should be 0. 


getprm 
The address of a longword used by getrtn. If the standard read routine is to be 
used, this value should be 0. 


Description 


The VIEWER FILE routine opens a file and begins to convert the contents of the 
file to in-memory DDIF-. If there is currently a file that is open, it is immediately 
closed, the viewer window is cleared, and the new file is opened. 


RETURN VALUES 

Return Value Description 

DVR$_NORMAL The file was opened and a window of content was con- 
verted to in-memory DDIF and displayed in the CDA 
Viewer widget window. 

DVR$_NOCONVERTER There was no converter for the specified format. 

DVR$_DDIFERROR There was an error when converting the file to in-memory 
DDIF. 

DVR$_FILENOTOPEN The file could not be opened. 

CDA$_xxxx Any CDA return status. 
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Appendix A 
DDIF Fill Patterns 


This appendix describes the various fill patterns supported by the CDA Toolkit. 
These fill patterns correspond to those used by the Graphics Kernel System 
(GKS). They are valid for the following aggregate items: 


The text mask pattern item (DDIF$_SGA_TXT_MASK_PATTERN) in the 
DDIF$_SGA aggregate 


The line mask pattern item (DDIF$_SGA_LIN_MASK_PATTERN) in the 
DDIF$_SGA aggregate 


The line interior pattern item (DDIF$_SGA_LIN_INTERIOR_PATTERN) in 
the DDIF$_SGA aggregate 


The marker mask pattern item (DDIF$_SGA_MKR_MASK_ PATTERN) in the 
DDIF$_SGA aggregate 

The pattern number item (DDIF$_PTD_NUMBER) in the DDIF$_PTD 
aggregate 

The pattern colors item (DDIF$_PTD_PAT_NUMBER) in the DDIF$_PTD 
aggregate 


Table A—1 describes each predefined fill pattern and shows its symbolic name and 
its corresponding DDIF pattern number. Figure A-1 illustrates each predefined 
fill pattern. 


Table A-—1: DDIF Fill Patterns 


Pattern Name Number Description 

DDIF$K_PATT_ BACKGROUND 1 The pattern is white. 

DDIF$K_PATT_FOREGROUND 2 The pattern is black. 

DDIF$K_PATT_VERT1_1 3 The thickness ratio of black to 
white vertical lines in the pattern 
isl: 1. 

DDIF$K_PATT_VERT1_3 4 The thickness ratio of black to 
white vertical lines in the pattern 
isl: 3. 

DDIF$K_PATT_VERT2_2 5 The thickness ratio of black to 


white vertical lines in the pattern 
is 2-9 42. 


(continued on next page) 


DDIF Fill Patterns A-—1 


Table A-1 (Cont.): DDIF Fill Patterns 
Pattern Name 


DDIF$K_PATT_VERT3_1 
DDIF$K_PATT_VERT1_7 
DDIF$K_PATT_VERT2_6 
DDIF$K_PATT_VERT4_4 
DDIF$K_PATT_VERT6_2 
DDIF$K_PATT_HORIZ1_1 
DDIF$K_PATT_HORIZ1_3 
DDIF$K_PATT_HORIZ2_2 
DDIF$K_PATT_HORIZ3_1 
DDIF$K_PATT_HORIZ1_7 
DDIF$K_PATT_HORIZ2_6 
DDIF$K_PATT_HORIZ4_4 
DDIF$K_PATT_HORIZ6_2 


DDIF$K_PATT_GRID4 
DDIF$K_PATT_GRID8 


DDIF$K_PATT_UPDIAG1_3 


A-2 DDIF Fill Patterns 


Number Description 


6 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


The thickness ratio of black to 
white vertical lines in the pattern 
is3: 1. 

The thickness ratio of black to 
white vertical lines in the pattern 
isl: 7. 

The thickness ratio of black to 
white vertical lines in the pattern 
is2: 6. 

The thickness ratio of black to 
white vertical lines in the pattern 
is 4: 4. 

The thickness ratio of black to 
white vertical lines in the pattern 
is6: 2. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 1: 1. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 1: 3. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 2 : 2. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 3 : 1. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 1: 7. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 2 : 6. 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 4: 4, 

The thickness ratio of black to 
white horizontal lines in the 
pattern is 6 : 2. 

Each grid box has 4 units to a 
side. 

Each grid box has 8 units to a 
side. 

The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the patternis1 : 3. 
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Table A-1 (Cont.): DDIF Fill Patterns 
Pattern Name Number Description 


DDIF$K_PATT_UPDIAG2 2 22 The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 2 : 2. 


DDIF$K_PATT_UPDIAG3_1 23 The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 3 : 1. 


DDIF$K_PATT_UPDIAG1_7 24 The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 1 : 7. 


DDIF$K_PATT_UPDIAG2_6 25 The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 2 : 6. 


DDIF$K_PATT_UPDIAG4_4 26 The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 4 : 4. 


DDIF$K_PATT_UPDIAG6_2 ZT The thickness ratio of black to 
white upward diagonal lines 
(going up from left to right) in 
the pattern is 6 : 2. 


DDIF$K_PATT_DOWNDIAG1_3 28 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 1: 3. 


DDIF$K_PATT_DOWNDIAG2_2 29 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 2 : 2. 


DDIF$K_PATT_DOWNDIAG3_1 30 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 3 : 1. 


DDIF$K_PATT_DOWNDIAG1_7 31 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 1: 7. 
DDIF$K_PATT_DOWNDIAG2_6 32 The thickness ratio of black to 
. white downward diagonal lines 
(going down from left to right) in 
the pattern is 2 : 6. 
DDIF$K_PATT_DOWNDIAG4_4 33 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 4 : 4. 


(continued on next page) 
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Table A-—1 (Cont.): DDIF Fill Patterns 
Pattern Name Number Description 


DDIF$K_PATT_DOWNDIAG6_2 34 The thickness ratio of black to 
white downward diagonal lines 
(going down from left to right) in 
the pattern is 6 : 2. 


DDIF$K_PATT_BRICK_HORIZ 35 The pattern is composed of bricks 
oriented in a horizontal direction. 

DDIF$K_PATT_BRICK_VERT 36 The pattern is composed of bricks 
oriented in a vertical direction. 

DDIF$K_PATT_BRICK_DOWNDIAG 37 The pattern is composed of bricks 


oriented in a downward diagonal 
pattern (going down from left to 
right). 


DDIF$K_PATT_BRICK_UPDIAG 38 The pattern is composed of bricks 
oriented in an upward diagonal 
pattern (going up from left to 
right). 


DDIF$K_PATT_GREY4_16D 39 The ratio of black dots to the total 
number of dots in the pattern is 
4: 16. 


DDIF$K_PATT_GREY12_16D 40 The ratio of black dots to the total 
number of dots in the pattern is 
12: 16. 


DDIF$K_PATT_BASKET_WEAVE Al The pattern is composed of a 
basket-weave pattern. 


DDIF$K_PATT_SCALE_DOWN 42, The pattern is composed of 
downward-oriented scales. 


DDIF$K_PATT_SCALE_UP 43 The pattern is composed of 
upward-oriented scales. 


DDIF$K_PATT_SCALE_RIGHT 44 The pattern is composed of 
rightward-oriented scales. 


DDIF$K_PATT_SCALE_LEFT 45 The pattern is composed of 
leftward-oriented scales. 
DDIF$K_PATT_FILLER6 46 The pattern is a filler pattern. 
DDIF$K_PATT_FILLER7 47 The pattern is a filler pattern. 
DDIF$K_PATT_GREY1_16 48 The ratio of black dots to the total 


number of dots in the pattern is 
1: 16. 


DDIF$K_PATT_GREY2_16 49 The ratio of black dots to the total 
number of dots in the pattern is 
2: 16. 


DDIF$K_PATT_GREY3_16 50 The ratio of black dots to the total 
number of dots in the pattern is 
3: 16. 


DDIF$K_PATT_GREY4_16 51 The ratio of black dots to the total 
number of dots in the pattern is 
4: 16. 
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Table A-1 (Cont.): DDIF Fill Patterns 
Pattern Name 


DDIF$K_PATT_GREY5_16 
DDIF$K_PATT_GREY6_16 
DDIF$K_PATT_GREY7_16 
DDIF$K_PATT_GREY8_16 
DDIF$K_PATT_GREY9_16 
DDIF$K_PATT_GREY10_16 
DDIF$K_PATT_GREY11_16 
DDIF$K_PATT_GREY12_16 
DDIF$K_PATT_GREY13_16 
DDIF$K_PATT_GREY14_16 


DDIF$K_PATT_GREY15_16 


Number Description 


52 


53 


54 


55 


56 


57 


58 


59 


60 


61 


62 


The ratio of black dots to the total 
number of dots in the pattern is 
5 : 16. 

The ratio of black dots to the total 
number of dots in the pattern is 
6: 16. 

The ratio of black dots to the total 
number of dots in the pattern is 
7: 16. 

The ratio of black dots to the total 
number of dots in the pattern is 
8: 16. 


The ratio of black dots to the total 
number of dots in the pattern is 
9: 16. 

The ratio of black dots to the total 
number of dots in the pattern is 
10 : 16. 


The ratio of black dots to the total 
number of dots in the pattern is 
11 : 16. 


The ratio of black dots to the total 
number of dots in the pattern is 
12 : 16. 

The ratio of black dots to the total 
number of dots in the pattern is 
13 : 16. 


The ratio of black dots to the total 
number of dots in the pattern is 
14 : 16. 


The ratio of black dots to the total 
number of dots in the pattern is 
15: 16. 
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Figure A-1: CDA Fill Patterns 
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Appendix B 
DDIF Syntax Diagrams 





This appendix lists the syntax diagrams for each construct defined by DDIF 
(DIGITAL Document Interchange Format). The diagram for each construct 

is listed alphabetically under Syntax diagrams in the index. For example, 
Figure B—6 shows the syntax used to create a DDIF document construct and is 
listed as DDIFDocument under Syntax diagrams in the index. 


The abstract syntax notation used to define these constructs at the lowest level is 
DDIS (DIGITAL Data Interchange Syntax). The elements of the DDIS abstract 
syntax notation that are used in this appendix are summarized in the following 
sections. 


B.1 DDIS Built-In Data Types 


Table B—1 lists the built-in types that are primitive data types. 


Table B—1: DDIS Built-In Primitives 


Type Definition 

NULL A data element with no value. 

INTEGER A signed, two’s complement binary number. 

BOOLEAN A Boolean value, constrained to be true or false. 

BIT STRING A string of bits. 

OCTET STRING A character string or other data type that logically 
consists of a series of “octet” (8-bit quantity) values. 

FLOATING-POINT An element that consists of a sign magnitude, with bit 


7 of the second octet representing the sign bit. Bits 

6 through 0 of the second octet and bits 7 through 0 

of the first octet collectively encode an excess-16384 
binary exponent. The bits of the exponent decrease in 
significance from bit 6 to bit 0 of the second octet, and 
then from bit 7 to bit 0 of the first octet. The remaining 
(zero or more) octets of the value encode a normalized 
fraction with the redundant most significant bit not 
represented. The fraction is encoded such that bits 
increase in significance from bit 0 through bit 15 of each 
octet pair, and successive pairs of octets become less 
significant. 


(continued on next page) 
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Table B—1 (Cont.):  DDIS Built-In Primitives 


Type | Definition 
OBJECT IDENTIFIER A list of object identifier components, which are integer 


values that identify branches in a tree of object iden- 
tifiers. The value field of an element of type OBJECT 
IDENTIFIER consists of an ordered list of subidenti- 
fiers, where each subidentifier is an unsigned integer 
value. Each subidentifier is represented as one or more 
octets. If bit 7 of a given octet is set, the subidentifier 
is continued in the next octet. Bits 6 through 0 of the 
octets in the subidentifier collectively encode an integer 
that represents a branch in the registration tree. These 
bits are concatenated to form an unsigned integer whose 
most significant bit is bit 6 of the first octet and whose 
least significant bit is bit 0 of the last octet. 
EXTERNAL A data value whose basic encoding may or may not 
conform to DDIS. The direct-reference element in 
the EXTERNAL data type indicates the data type 
(syntax and semantics) of the external element. The 
data-value descriptor element is a text string that 
describes the data value in a human-readable form. The 
encoding field contains the data value itself. Refer to the 
description of the corresponding DDIF$_EXT aggregate 
in Chapter 4. 


The DDIF syntax diagrams also refer to a Generalized Time universal defined 
type. This type represents a calendar date and time of day to various precisions. 
The time of day can be specified as local time only, as Coordinated Universal 
Time (UTC) only, or as both local and UTC. 


The Generalized Time type represents time by a string of characters consisting of: 
¢ Acalendar date 

e A time of day 

¢ The local time differential factor (TDF) 

In addition to these primitive data types, DDIS also provides built-in constructors 


(records and arrays). Table B—2 shows the DDIS constructors used in the DDIF 
syntax diagrams. 


Table B—2: DDIS Built-in Constructors 


Constructor Definition 


SEQUENCE A list of elements that can be primitive or themselves con- 


structed, which must occur in the order in which the elements 
are specified. A SEQUENCE can be viewed as a record in which 
each field has a type identifier in the data stream. All elements 
of a SEQUENCE are enclosed within braces. 

SEQUENCE OF A list of elements that can be primitive or themselves con- 
structed, which are all of a specified type. For example, a 
“SEQUENCE OF INTEGER” models a list of integers. 


DDIS also provides tagged types. Elements in the syntax are often assigned 
tags for the purpose of making them unique within their context. These tags, 
shown in the syntax as a number between square brackets, serve to identify the 
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element. Note that they are not counters; while they are conventionally assigned 
in ascending order to elements of a constructor type, they are not constrained to 
do so. Elements of a SEQUENCE occur in the order in which they are listed. 


Tagged types can use the IMPLICIT keyword to specify that the tagged type 
assumes the encoding of the referenced type, rather than forming a constructor 
containing a built-in element. Use of the IMPLICIT keyword reduces the number 
of bytes required to represent the encoded data, but requires that decoding 
software have knowledge of the type. 


B.2 Built-in Operators 


Table B-3 describes the DDIS built-in operators. They are best described as 
operators because they affect the way the built-in types are encoded. The 
keywords for built-in operators are expressed in uppercase letters. 


Table B-3: DDIS Built-In Operators 


Operator 


CHOICE 


OPTIONAL 


DEFAULT 


ANY 


Assignment 


Named number 


Comments 


B.3 DDIS Defined Types 


Effects 


Only one of the list of alternative types can be chosen. Note 
that CHOICE is not a type that has a tag. It therefore cannot 
be preceded by the IMPLICIT operator. CHOICE can force 

a tagged type to become a constructor that then contains the 
chosen alternative. 


The designated element can be omitted at the option of the 
sending application. 


The designated element has a default value. Elements with 
default values are also optional and can be omitted at the 
option of the sending application. The receiving application 
uses the specified default value when the element is missing 
from the encoding. 


Any tagged element can be inserted in the encoding, at the 
option of the sending application. 


The assignment operator, represented by two colons and an 
equal sign (::=), assigns a name to a syntax definition by which 
it can be referenced in other definitions. Elements of a syntax 
can therefore share a definition. 


The assignment of an identifier to a specific value represented 
by identifier (number). Named numbers are often used for 
clarity in referring to values with specific meaning, and to 
provide for automatic generation of symbolic values for use in 
software development. (By convention, named integer values 
in DDIF start from 1 and named bits start from bit 0.) 


The comment delimiter, represented by two consecutive hyphen 
characters (- -), causes the text following this delimiter to be 
treated as a comment. 


Table B—4 shows the types defined by DDIS. 
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Table B—4: DDIS Defined Types 


Defined Type 
Latin1-String 


Character-String 


Text-String 


ObjectDescriptor 


Figure B-1 illustrates the syntax 


Figure B—1: Object Descriptor Syntax Diagram 


ObjectDescriptor :: 


Figure B-2 illustrates the syntax 


Figure B—2: Latin1 String Syntax Diagram 


Latinil-String ::= [PRIVATE 20] 
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Encoding 


An element encoded as an OCTET STRING in which 
all octet values represent characters from the Latin1 
character set. Characters 32 through 126 of this 
character set are the same as the 7-bit ASCII code. 
Refer to the description of the DDIF$_TXT aggregate 
in Chapter 4. 


An element in which the first octet or octets identify 
the character set, and the remaining octets constitute 
the codes of characters selected from that character 
set. The characters in a Character-String type can 
be chosen from 8-bit, 16-bit, and 32-bit character 
sets. 


An element that consists of a sequence of Character- 
String elements, and can thus represent a text string 
in which characters are selected from more than one 
character set. 


A type that models human-readable text that de- 
scribes a data value. This text need not be unique 
within any context, as it is purely descriptive. 


used to create an object descriptor construct. 


[UNIVERSAL 7] IMPLICIT OCTET STRING 


used to create a Latin1 construct. 


IMPLICIT OCTET STRING 


Figure B—3 illustrates the syntax used to create a text string construct. 


Figure B-3: Text String Syntax Diagram 


Text-String ::=[{ PRIVATE 10 }] IMPLICIT SEQUENCE OF Character-String 


Figure B—4 illustrates the syntax used to create a character string construct. 


Figure B—4: Character String Syntax Diagram 


Character-String ::= [PRIVATE 9] IMPLICIT OCTET STRING 


Figure B—5 illustrates the syntax used to create an application private data 
construct. 


Figure B—5: Application Private Data Syntax Diagram 


ApplPrivate ::= NamedValueList 


B.4 DDIF Syntax Diagrams 


This section lists all the syntax diagrams that are used to describe DDIF 
constructs. Figure B-6 illustrates the syntax used to create a DDIF document 
construct. 


Refer to the description of the corresponding DDIF$_DDF aggregate in 
Chapter 4. 


Figure B-6: DDIF Document Syntax Diagram 


DDIFDocument ::= [PRIVATE 16383] IMPLICIT SEQUENCE { 
document-descriptor [0] IMPLICIT DocumentDescriptor, 
document—-header [1] IMPLICIT DocumentHeader, 
document-content [2] IMPLICIT Content 


} 


Figure B-7 illustrates the syntax used to create a document descriptor construct. 


Refer to the description of the corresponding DDIF$_DSC aggregate in 
Chapter 4. 
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Figure B-7: Document Descriptor Syntax Diagram 


DocumentDescriptor 
major-version 
minor-version 
product-identifier 
product—name 


::= SEQUENCE { 


[0] IMPLICIT INTEGER, 

{1] IMPLICIT INTEGER, 

{2] IMPLICIT ASCIIString, 
{3] IMPLICIT Text-String 
} 





Figure B-8 illustrates the syntax used to create a document header construct. 


Refer to the description of the corresponding DDIF$_DHD aggregate in 


Chapter 4. 


Figure B-8: Document Header Syntax Diagram 


DocumentHeader 


private-header-data 


title 

author 

version 

date 
conformance-tags 


external-references 


languages 


iso-639-language 
other-language 


style-guide 


::= SEQUENCE { 
{0] IMPLICIT NamedValueList OPTIONAL, 
{1] IMPLICIT Text-String OPTIONAL, 
{2] IMPLICIT Text-String OPTIONAL, 
[3] IMPLICIT Text-String OPTIONAL, 


[4] IMPLICIT GeneralizedTime OPTIONAL, 
[5] IMPLICIT SEQUENCE OF ConformanceTag OPTIONAL, 
[6] IMPLICIT SEQUENCE OF ExternalReference 
OPTIONAL, 
{7] IMPLICIT SEQUENCE OF CHOICE { 
[0] IMPLICIT ASCITString, 
[1] IMPLICIT Character-String 
} OPTIONAL, 
[8] IMPLICIT ExternalRefIndex OPTIONAL 


Figure B—9 illustrates the syntax used to create a document root segment 


construct. 


Figure B-9: Document Root Segment 


Content 

ContentPrimitive 
segment-primitive 
text-primitive 


formatting-primitive 
graphics-primitive 


image-primitive 


content-ref-primitive 
restricted-content 


layout-primitive 


} 


::= SEQUENCE OF ContentPrimitive 
::= CHOICE { 


SegmentPrimitive, 
TextPrimitive, 
FormattingPrimitive, 
GraphicsPrimitive, 
ImagePrimitive, 
ContentReferencePrimitive, 
RestrictedContent, 
LayoutPrimitive 
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Figure B-10 illustrates the syntax used to create a segment primitive construct. 


Figure B-10: Segment Primitive Syntax Diagram 
SegmentPrimitive ::= CHOICE { 
end-segment [APPLICATION 1] IMPLICIT NULL, 
begin-segment [APPLICATION 2] IMPLICIT BeginSegment 
} 
Figure B-11 illustrates the syntax used to create a construct. 
Refer to the description of the corresponding DDIF$_SEG aggregate in 
Chapter 4. 
Figure B—11: Begin-Segment Syntax Diagram 
BeginSegment ::= SEQUENCE { 
segment-id [0] IMPLICIT SegmentLabel OPTIONAL, 
user-label {1] IMPLICIT Text-String OPTIONAL, 
segment-type [2] IMPLICIT TypeDefnLabel OPTIONAL, 
specific-—attributes [3] IMPLICIT SegmentAttributes OPTIONAL, 
generic-layout [4] ANY OPTIONAL, 
specific-—layout [5] ANY OPTIONAL 


Figure B-12: 


} 


Figure B-12 illustrates the syntax used to create a text primitive construct. 


Refer to the description of the corresponding DDIF$_GTX aggregate in 
Chapter 4. 


Text Primitive Syntax Diagram 


TextPrimitive ::= CHOICE { 
latinl-content [APPLICATION 3] IMPLICIT Latinl-String, 
general-text-content {APPLICATION 4] IMPLICIT Character-String 


} 


Figure B—13 illustrates the syntax used to create a text attributes construct. 


Refer to the description of the corresponding Text Attributes, Text Font Attribute, 
Text Rendition Attribute, Text Size Attribute, the Text Direction Attribute, the 
Text Character Decimal Alignment Attribute, the Text Leader Attributes, and to 
the Text Kerning Attribute for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B-13: Text Attributes Syntax Diagram 





TextAttributes ::= SEQUENCE { 
text-mask-pattern [0] IMPLICIT PatternNumber OPTIONAL, 
text-font [1] IMPLICIT FontNumber OPTIONAL, 
text-rendition (2] IMPLICIT SEQUENCE OF 
; RenditionCode OPTIONAL, 
text—-height [3] Size OPTIONAL, 
text-set-size {4] IMPLICIT Ratio OPTIONAL, 
text-direction [5] IMPLICIT INTEGER { 
text-dir-forward(1), 
text-dir-backward (2) } OPTIONAL, 
decimal-align-chars {6] IMPLICIT SEQUENCE OF 
Character-String OPTIONAL, 
leader-attributes [7] IMPLICIT LeaderStyle OPTIONAL, 
pair-kerning [8] IMPLICIT BOOLEAN OPTIONAL 


Figure B—-14 illustrates the syntax used to create a rendition code construct. 


Refer to the description of the corresponding Text Rendition Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—14: Rendition Code Syntax Diagram 


RenditionCode ::= INTEGER { 
default (0), 
highlighted(1l), 
faint (2), 
italic(3), 
underlined (4), 
slow-blink (5), 
rapid-blink (6), 
negative-image(7), 
concealed-chars (8), 
crossed-out (9), 
double-underlined(21), 
normal-intensity (22), 
not-underlined(24), 
steady (25), 
positive (27), 
revealed-chars (28), 
boxed (51), 
encircled(52), 
overlined (53), 
ideogram-underlined(60), 
ideogram-db-underlined(61), 
ideogram-overlined (62), 
ideogram-db-overlined(63), 
ideogram-stress-—mark (64) } 


Figure B~15 illustrates the syntax used to create a leader style construct. 


Refer to the description of the corresponding Text Leader Attributes for the 
DDIF$_SGA aggregate in Chapter 4. 
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Figure B—15: Leader Style Syntax Diagram 


LeaderStyle 
leader-space 
leader-bullet 
leader-align 


::= SEQUENCE { 


[0] Size OPTIONAL, 
[1] IMPLICIT Character-String OPTIONAL, 
[2] IMPLICIT INTEGER { 


aligned-leader (1), 
staggered-leader (2), 


non-aligned-leader(3) } 


leader-style 
ls-x-rule(1), 
ls-bullet (2) 


OPTIONAL, 
[3] IMPLICIT INTEGER { 


} OPTIONAL 


Figure B—16 illustrates the syntax used to create a text layout construct. 


Refer to the description of the corresponding Layout Attribute, to the Galley- 
Based Layout Attribute, to the Path-Based Layout Attribute, to the Position- 
Relative Layout Attribute, and to the Text Position Attribute for the DDIF$_SGA 
aggregate in Chapter 4 


Figure B-16: Text Layout Syntax Diagram 


Text Layout 73 
galley-based-layout 
wrap-attributes 
galley-layout 


path-based-layout 

position-relative 
vertical-offset 
horizontal-offset 


text-position 
tp-base(1), 


CHOICE { 
{O0] IMPLICIT SEQUENCE { 
[0] ANY OPTIONAL, 
[1] ANY OPTIONAL 
}, 
[1] IMPLICIT StringLayout, 
{2] IMPLICIT SEQUENCE { 
[0] IMPLICIT Escapement OPTIONAL, 
[1] IMPLICIT Escapement OPTIONAL 
4, 
{3] IMPLICIT INTEGER { 


tp-left-subscript (2), 
tp-left-superscript (3), 
tp-right-subscript (4), 
tp-right-superscript (5), 

tp-top-center (6), 

tp-bottom-center (7), 

tp-rubi (8) a 


Figure B-17 illustrates the syntax used to create a text string layout construct. 


Refer to the description of the corresponding Path-Based Layout Attribute for the 


DDIF$_SGA aggregate in Chapter 4. 
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Figure B—17: Text String Layout Syntax Diagram 


StringLayout ::= SEQUENCE { 

string-layout~—path {O0] IMPLICIT CompositePath, 
string-layout-format [1] IMPLICIT Format DEFAULT flush-path-begin, 
character-orientation CHOICE { 

char-angle-fixed {2] IMPLICIT Angle, 

char-angle-path [3] IMPLICIT RightAngle 

} DEFAULT { char-angle-path up }, 

char-horizontal-align [4] IMPLICIT INTEGER { 


normal—-horizontal (1), 

leftline(2), 

centerline (3), 

rightline (4) } DEFAULT normal-horizontal, 
char-vertical-align [5] IMPLICIT INTEGER { 

normal-vertical (1), 

baseline (2), 

capline (3), 

bottomline (4), 

halfline (5), 

topline(6) } DEFAULT normal-vertical 


Figure B—18 illustrates the syntax used to create a formatting primitive construct. 


Refer to the description of the corresponding DDIF$_HRD aggregate, DDIF$_HRV 
aggregate, DDIF$_SFT aggregate, and DDIF$_SFV aggregate in Chapter 4. 


Figure B-18: Formatting Primitive Syntax Diagram 


FormattingPrimitive ::= CHOICE { 
soft-value-directive [APPLICATION 7] ValueDirective, 
hard-value-directive [APPLICATION 8] ValueDirective, 
hard-directive [APPLICATION 9] IMPLICIT Directive, 
soft-directive {APPLICATION 10] IMPLICIT Directive 


} 


Figure B—19 illustrates the syntax used to create a value directive construct. 


Refer to the description of the corresponding DDIF$_HRV aggregate in 
Chapter 4. 


Figure B-19: Value Directive Syntax Diagram 


ValueDirective ::= CHOICE { 
escapement-directive [0] IMPLICIT EscapementDirective, 
variable-reset {1] IMPLICIT VariableReset 


} 


Figure B—20 illustrates the syntax used to create a directive construct. 
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Refer to the description of the corresponding DDIF$_HRD aggregate, the 
DDIF$_LL1 aggregate, and the DDIF$_SFT aggregate in Chapter 4. 


Figure B-20: Directive Syntax Diagram 


Directive ::= INTEGER { 
new-page (1), 
new-line (2), 
new-galley (3), 
tab(4), 
space (5), 
hyphen-new-line (6), 
word-break-point (7), 
leaders (8), 
backspace (9), 
null-directive (10), 
no-hyphen-word (11) } 


Figure B—21 illustrates the syntax used to create an escapement directive 
construct. 


Refer to the description of the corresponding DDIF$_HRV aggregate in 
Chapter 4. 


Figure B-21: Escapement Directive Syntax Diagram 


EscapementDirective ::= Escapement 


Figure B—22 illustrates the syntax used to create a variable reset construct. 


Refer to the description of the corresponding DDIF$_HRV aggregate in 
Chapter 4. 


Figure B-22: Variable Reset Syntax Diagram 


VariableReset ::= SEQUENCE { 
reset-variable [0] IMPLICIT VariableLabel, 
reset-value [1] Expression 


} 


Figure B—23 illustrates the syntax used to create a graphics primitive construct. 


Figure B-23: Graphics Primitive Syntax Diagram 


GraphicsPrimitive ::= CHOICE { 
cubic-curve-object [APPLICATION 11] IMPLICIT CubicBezier, 
polyline-object {APPLICATION 12] IMPLICIT Polyline, 
arc-object {APPLICATION 13] IMPLICIT Arc, 
fill-area-set [APPLICATION 14] IMPLICIT FillAreaSet 


} 


Figure B—24 illustrates the syntax used to create a polyline construct. 
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Refer to the description of the corresponding DDIF$_LIN aggregate in Chapter 4. 


Figure B-24: Polyline Syntax Diagram 


Polyline ::= SEQUENCE { 

polyline-flags {O] IMPLICIT BIT STRING { 

draw-polyline (0), 

fill-polyline (i), 

draw-markers (2), 

regular-polygon (3), 

close-polyline (4), 

rounded-polyline (5), 

rectangular-polygon(6) } DEFAULT { draw-polyline }, 
polyline-draw-pattern [1] IMPLICIT BIT STRING DEFAULT /1’B, 
polyline-path {2] IMPLICIT PolyLinePath 

} 


Figure B-25 illustrates the syntax used to create a cubic Bézier construct. 


Refer to the description of the corresponding DDIF$_BEZ aggregate in 
Chapter 4. 


Figure B-25: Cubic Bézier Syntax Diagram 


CubicBezier ::= SEQUENCE { 
cubic-Bezier-flags [0] IMPLICIT BIT STRING { 
draw-cb (0), 
fill-cb(1), 
close-cb (2) } DEFAULT { draw-cb }, 
cubic—Bezier-path {1] IMPLICIT CubicBezierPath 


} 


Figure B-26 illustrates the syntax used to create an arc construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate in 
Chapter 4. 


Figure B—26: Arc Syntax Diagram 


Arc ::= SEQUENCE { 
arc-flags [0] IMPLICIT BIT STRING { 
draw-arc(0), 
fill-arc(1), 
pie-arc (2), 
close-arc (3) } DEFAULT { draw-arc }, 
arc-path [1] IMPLICIT ArcPath 


} 


Figure B-27 illustrates the syntax used to create a fill area set construct. 


Refer to the description of the corresponding DDIF$_FAS aggregate in 
Chapter 4. 


Figure B-28 illustrates the syntax used to create a line attributes construct. 
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Figure B-27: Fill Area Set Syntax Diagram 


FillAreaSet ::= SEQUENCE { 
fas-flags {O] IMPLICIT BIT STRING { 
co-draw-border (0), 
co-fill-area(1) } DEFAULT { co-draw-border }, 
fas-path {1] IMPLICIT CompositePath 


} 


Refer to the description of the corresponding Line Attributes for the DDIF$_SGA 
aggregate in Chapter 4. 
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Figure B-28: Line Attributes Syntax Diagram 


LineAttributes ::= SEQUENCE { 
line-width [0] Size OPTIONAL, 
line-style [1] IMPLICIT LineStyleNumber OPTIONAL, 
line-pattern-size [2] Size OPTIONAL, 
line-mask-pattern [3] IMPLICIT PatternNumber OPTIONAL, 
line-end-start [4] IMPLICIT LineEndNumber OPTIONAL, 
line-end-finish [5] IMPLICIT LineEndNumber OPTIONAL, 
line-end-size [6] Size OPTIONAL, 
line-join {(7] IMPLICIT LineJoin OPTIONAL, 
line-miter-limit (8] IMPLICIT Ratio OPTIONAL, 
line-interior-pattern {[9] IMPLICIT PatternNumber OPTIONAL 


} 


Figure B-29 illustrates the syntax used to create a line style number construct. 


Refer to the description of the Line Attributes for the DDIF$_SGA aggregate in 


Chapter 4. 


LineStyleNumber t:= 


solid(1), 
dash(2), 
dot (3), 
dash-dot (4) 


INTEGER { 


Figure B—29: Line Style Number Syntax Diagram 


Figure B-30 illustrates the syntax used to create a line end number construct. 
Refer to the description of the corresponding Line Attributes for the DDIF$_ SGA 


Figure B--30: 


LineEndNumber 


aggregate in Chapter 4. 


Line End Number Syntax Diagram 


::= INTEGER { 


Figure B-31: 


butt-line-end(1), 
round-line-end(2), 
square-line-end (3), 
arrow (4) 


Figure B-31 illustrates the syntax used to create a line join construct. 


Refer to the description of the corresponding Line Attributes for the DDIF$_SGA 


aggregate in Chapter 4. 


LineJoin 13 


mitered-line-join(1), 
rounded-line-join(2), 
beveled-line-join (3) 
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Line Join Syntax Diagram 


INTEGER { 


Figure B-32 illustrates the syntax used to create a marker attributes construct. 


Refer to the description of the corresponding Marker Attributes for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B-32: Marker Attributes Syntax Diagram 
MarkerAttributes ::= SEQUENCE { 
marker-style {O] IMPLICIT MarkerNumber OPTIONAL, 
marker-mask-pattern [1] IMPLICIT PatternNumber OPTIONAL, 
marker-size [2] Size OPTIONAL 
} 
Figure B—33 illustrates the syntax used to create a marker number construct. 
Refer to the description of the corresponding Marker Attributes for the 
DDIF$_SGA aggregate in Chapter 4. 
Figure B~33: Marker Number Syntax Diagram 
MarkerNumber ::= INTEGER { 


marker-dot (1), 
marker-—plus-sign (2), 
marker-~asterisk (3), 
marker-circle (4), 
marker—-diagonal-cross (5) 


} 


Figure B-34 illustrates the syntax used to create an image primitive construct. 


Refer to the description of the corresponding DDIF$_IMG aggregate and to the 
DDIF$_IDU aggregate in Chapter 4. 


Figure B-34: Image Primitive Syntax Diagram 
ImagePrimitive ::= CHOICE { 
image-content [APPLICATION 17] IMPLICIT ImageDataDescriptor 


ImageDataDescriptor 


ImageDataUnit 
image 
image 


} 
SEQUENCE OF ImageDataUnit 


: SEQUENCE { 
-coding-attrs [0] IMPLICIT ImageCodingAttrs, 
-~comp-plane-data [1] IMPLICIT OCTET STRING 


} 


Figure B-35 illustrates the syntax used to create an image coding attributes 
construct. 


Refer to the description of the corresponding DDIF$_IDU aggregate and to the 
DDIF$_IMG aggregate in Chapter 4. 
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Figure B~35: Image Coding Attributes Syntax Diagram 


ImageCodingAttrs 
pvt-img-coding-attrs 
pixels-per-line 
number-of-lines 
compression-type 


SEQUENCE { 
(0] IMPLICIT NamedValueList OPTIONAL, 
{1] IMPLICIT INTEGER, 
{2] IMPLICIT INTEGER, 
{3] IMPLICIT INTEGER { 


private-compression (1), 

pcm-compression (2), -- (raw bitmap) 
g31d-compression (3), -- CCITT Group 3 1 dimensional 
g32d-compression (4), -- CCITT Group 3 2 dimensional 
g42d-compression (5) -- CCITT Group 4 2 dimensional 


} DEFAULT pcem-compression, 
NamedValueList OPTIONAL, 


compression-parameters {4] IMPLICIT 

data-offset [5] IMPLICIT INTEGER DEFAULT 0, 

pixel-stride {6] IMPLICIT INTEGER OPTIONAL, 

scanline-stride [7] IMPLICIT INTEGER OPTIONAL, 

pixel-order {8] IMPLICIT INTEGER { 
standard-pixel-order (1), 


reverse-pixel-order (2) } DEFAULT standard-pixel-order, 
planebits—per-pixel [9] IMPLICIT INTEGER OPTIONAL 
} 


Figure B-36 illustrates the syntax used to create an image attributes construct. 


Refer to the description of the corresponding Image Attributes for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B-36: Image Attributes Syntax Diagram 


ImageAttributes 
img-present-attrs 
img-comp-space-attrs 


SEQUENCE { 
[0] IMPLICIT 
{1] IMPLICIT 
} 


ImgPresentAttrs OPTIONAL, 
ImgCmptSpcAttrs OPTIONAL 


ImgPresentAttrs ::= SEQUENCE { 
prvt-img-present-attrs [0] IMPLICIT NamedValueList OPTIONAL, 
pixel-path {1] IMPLICIT INTEGER OPTIONAL, 
line-progression [2] IMPLICIT INTEGER OPTIONAL, 
pixel-aspect-ratio [3] IMPLICIT SEQUENCE { 
pxl-path-pxl-distance [0] IMPLICIT INTEGER DEFAULT 1, 
line-prog-pxl-distance {1] IMPLICIT INTEGER DEFAULT 1 
} OPTIONAL, 
brightness-polarity [4] IMPLICIT INTEGER { 
zero-maximum-intensity (1), 
zero-minimum-intensity (2) } OPTIONAL, 
grid-type [5] IMPLICIT INTEGER { 


rectangular-grid(1), 
hex-even-indent (2), 


hex-odd-indent (3) } 


OPTIONAL, 


timing-descriptor [6] IMPLICIT Binary-Relative-Time OPTIONAL, 
spectral-comp-mapping [7] IMPLICIT INTEGER { 
privately-mapped (1), 
monochrome-mapped (2), 
general-multispectral (3), 
lut-mapped (4), -- lookup table map 
rgb-mapped (5), -- red-green-blue 
cmy-mapped (6), -- cyan-magenta-yellow 
yuv-mapped (7), 
hsv-mapped (8), -- hue saturation value 
hls-mapped (9), -- hue lightness value 
yiq-mapped (10) } OPTIONAL, 
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(continued on next page) 


Figure B-36 (Cont.): Image Attributes Syntax Diagram 


lookup-tables [8] ImgLutData OPTIONAL, 
component-wlength-info [9] CHOICE { 
application~wlen-info [0] IMPLICIT SEQUENCE OF OCTET STRING, 
wavelength-measure {1] IMPLICIT SEQUENCE OF INTEGER, 
wavelength-band-id [2] IMPLICIT SEQUENCE OF Latinl-String 


} OPTIONAL 


Figure B-37 illustrates the syntax used to create an image lookup table data 
construct. 


Refer to the description of the corresponding Image Attributes for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—37: Image Lookup Table Data Syntax Diagram 


ImgLutData ::= CHOICE { 
application-pvt-luts {[O] IMPLICIT NamedValueList, 
rgb-lut-entries {1] IMPLICIT SEQUENCE OF RgbLutEntry 

} 

RgobLutkEntry ::= SEQUENCE { 
lut-index {O0] IMPLICIT INTEGER, 
red-value {1] IMPLICIT ColorIntensity, 
green-value [2] IMPLICIT Colorintensity, 
blue-value [3] IMPLICIT ColorIntensity 


} 


Figure B—38 illustrates the syntax used to create an image component space 
attributes construct. 


Refer to the description of the corresponding Image Component Space Attributes 
for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-38: Image Component Space Attributes Syntax Diagram 


ImgCmptSpcAttrs ::= SEQUENCE { 
comp-space-org {O] IMPLICIT INTEGER { 
full-compaction (1), 
partial-expansion (2), 


full-expansion(3) } OPTIONAL, 
data-planes-per-pixel {1] IMPLICIT INTEGER OPTIONAL, 
data-plane-signif {2] IMPLICIT INTEGER { 

isb-msb (1), 

msb-lsb (2) } OPTIONAL, 
number-of-components [3] IMPLICIT INTEGER, 
bits-per-component-l1st [4] IMPLICIT SEQUENCE OF INTEGER 


} 
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Figure B-39 illustrates the syntax used to create a restricted content construct. 


Figure B-39: Restricted Content Syntax Diagram 


RestrictedContent ::= CHOICE { 
pdl-content [APPLICATION 18] IMPLICIT EXTERNAL, 
private-content [APPLICATION 30] IMPLICIT NamedValue 
} 


Figure B-40 illustrates the syntax used to create a content reference primitive 
construct. 


Figure B—40: Content Reference Primitive Syntax Diagram 


ContentReferencePrimitive ::= CHOICE { 
content-ref [APPLICATION 15] IMPLICIT ContentReference 


} 


Figure B—41 illustrates the syntax used to create a content reference construct. 


Refer to the description of the corresponding DDIF$_CRF aggregate in 
Chapter 4. 


Figure B—41: Content Reference Syntax Diagram 


ContentReference ::= SEQUENCE { 
content-transform [0] IMPLICIT Transformation OPTIONAL, 
content-reference [1] IMPLICIT ContentDefnLabel 


} 


Figure B42 illustrates the syntax used to create a bounding box construct. 


Refer to the description of the corresponding DDIF$_GLY aggregate and to the 
Frame Bounding Box Attributes for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B-42: Bounding Box Syntax Diagram 


BoundingBox ::= SEQUENCE { 
lower-left [0] IMPLICIT Position, 
upper-right [1] IMPLICIT Position 


} 


Figure B—48 illustrates the syntax used to create a color construct. 


Refer to the description of the corresponding DDIF$_PTD aggregate in 
Chapter 4. 


Figure B—-43: Color Syntax Diagram 


Color ::= CHOICE { 
rgb-color {O] IMPLICIT RGB, 
transparency {1] IMPLICIT NULL 


} 


Figure B—44 illustrates the syntax used to create a red/green/blue construct. 


Refer to the description of the corresponding DDIF$_PTD aggregate and to the 
DDIF$_RGB aggregate in Chapter 4. : 


Figure B-44: Red/Green/Blue Syntax Diagram 


RGB ::= SEQUENCE { 
red-intensity [0] IMPLICIT ColorIntensity DEFAULT 0.0, 
green-intensity [1] IMPLICIT ColorIntensity DEFAULT 0.0, 
blue-intensity [2] IMPLICIT ColorIntensity DEFAULT 0.0 
} 
ColorIntensity = FLOATING-POINT 


Figure B—45 illustrates the syntax used to create a compute definition construct. 


Refer to the description of the Computed Content Attributes for the DDIF$_SGA 
aggregate in Chapter 4. 
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Figure B-45: Compute Definition Syntax Diagram 


ComputeDefn 2:= CHOICE { 
copy-content {O] IMPLICIT Reference, 
remote-content {1] IMPLICIT Reference, 
variable-reference {2] IMPLICIT VariableLabel, 
cross-reference [3] IMPLICIT CrossReference, 
function-link [4] IMPLICIT FunctionLink 


} 


Figure B—46 illustrates the syntax used to create a cross-reference construct. 


Refer to the description of the corresponding Cross-Reference Computed Content 
Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-46: Cross-Reference Syntax Diagram 


CrossReference ::= SEQUENCE { 
xref-seg-label [0] IMPLICIT Reference, 
xref-var-label {L] IMPLICIT VariableLabel 


} 


Figure B-47 illustrates the syntax used to create an escapement construct. 


Refer to the description of the DDIF$_HRV aggregate, the DDIF$_LL1 aggregate, 
and to the Position-Relative Layout Attribute for the DDIF$_SGA aggregate in 


Chapter 4. 


Figure B—-47: Escapement Syntax Diagram 


Escapement ::= SEQUENCE { 


escapement~-ratio [0] 
escapement-constant {1] 
} 


IMPLICIT Ratio OPTIONAL, 
Measurement OPTIONAL 


Figure B—48 illustrates the syntax used to create an external reference construct. 


Refer to the description of the corresponding DDIF$_ERF aggregate and the 
DDIF$_DHD aggregate in Chapter 4. 


Figure B—48: External Reference Syntax Diagram 


ExternalReference ::= SEQUENCE { 
reference-data-type [0] IMPLICIT OBJECT IDENTIFIER, 
reference-descriptor [1] IMPLICIT Text-String, 
reference-label [2] IMPLICIT Character-String, 
reference-label-type [3] IMPLICIT StorageSystemTag, 
reference-control {4] IMPLICIT INTEGER { 
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copy-reference (1), 
no-copy-reference (2) 


} 
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DEFAULT copy-reference 


Figure B—49 illustrates the syntax used to create a font definition construct. 


Refer to the description of the corresponding DDIF$_FTD aggregate and to the 
Font Definitions Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—49: Font Definition Syntax Diagram 


FontDefn ::= SEQUENCE { 
font-number {O] IMPLICIT FontNumber, 
font-identifier [1] IMPLICIT Latinl-String, 
font-private {2] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B—50 illustrates the syntax used to create a format construct. 


Refer to the description of the corresponding DDIF$_LW1 aggregate, the Path- 
Based Layout Attribute, the Frame Position Attribute, and to the Galley Frame 
Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—50: Format Syntax Diagram 


Format ::= INTEGER { flush-path-begin(1), center-of-path(2), 
flush-path-end(3), flush-path-both (4) 
} 


Figure B—51 illustrates the syntax used to create a frame parameters construct. 


Refer to the description of the corresponding Frame Parameters Attributes, the 
Frame Flags Attribute, the Frame Bounding Box Attribute, the Frame Outline 
Attribute, the Frame Clipping Attribute, the Frame Position Attribute, the Fixed 
Frame Parameters, the Inline Frame Parameters, the Galley Frame Parameters, 
the Margin Frame Parameters, and to the Frame Content Transformation 
Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-51: Frame Parameters Syntax Diagram 


FrameParameters ::= SEQUENCE { 
frame-flags [O] IMPLICIT BIT STRING { 
flow-around (0), 
frame-border (1), 
frame-background-fill(2) } OPTIONAL, 


frame—-bounding-box [1] IMPLICIT BoundingBox, 
frame-outline [2] IMPLICIT CompositePath OPTIONAL, 
frame-clipping {3] IMPLICIT CompositePath OPTIONAL, 
frame-position CHOICE { 
fp-fixed [4] IMPLICIT Position, 
fp-inline {5] IMPLICIT InlineFrameParams, 
fp-galley [6] IMPLICIT GalleyFrameParams, 
fp-margin [7] IMPLICIT MarginFrameParams 
}, 
frame-content-trans [8] IMPLICIT Transformation OPTIONAL 


} 


Figure B—52 illustrates the syntax used to create an inline frame parameters 
construct. 
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Figure B-52: Inline Frame Parameters Syntax Diagram 


InlineFrameParams - ::= SEQUENCE { 
ifp-base-offset [0] Size DEFAULT { integer-constant 0 } 
} 


Refer to the description of the corresponding Frame Position Attribute and to the 
Inline Frame Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—53 illustrates the syntax used to create a galley frame parameters 
construct. 


Refer to the description of the corresponding Frame Position Attribute and to the 
Galley Frame Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—53: Galley Frame Parameters Syntax Diagram 


GalleyFrameParams ::= SEQUENCE { 
gfip-vertical [0] IMPLICIT GalleyVerticalPosition 
DEFAULT below-current-line, 
gfp-horizontal {1] IMPLICIT Format DEFAULT center-of-path 


} 


Figure B—54 illustrates the syntax used to create a galley vertical position 
construct. 


Refer to the description of the corresponding Frame Position Attribute and to the 
Galley Frame Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-54: Galley Vertical Position Syntax Diagram 


GalleyVerticalPosition ::= INTEGER { 
below-current-line (1), 
bottom-of-galley (2), 
top-of-galley (3) 

} 


Figure B—55 illustrates the syntax used to create a margin frame parameters 
construct. 


Refer to the description of the corresponding Frame Position Attribute and to the. 
Margin Frame Parameters for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B—55: Margin Frame Parameters Syntax Diagram 


MarginFrameParams ::= SEQUENCE { 
mfp-base-offset [0] Size DEFAULT { integer-constant 0 }, 
mfp-near-offset [1] Size DEFAULT { integer-constant 0 }, 
mfp-horizontal [2] IMPLICIT MarginHorizontalPosition 


DEFAULT side-closest-edge 
} 


Figure B—56 illustrates the syntax used to create a margin horizontal position 
construct. 


Refer to the description of the corresponding Frame Position Attribute and to the 
Margin Frame Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—56: Margin Horizontal Position Syntax Diagram 


MarginHorizontalPosition ::= INTEGER { 
side-closest-edge(1), 
side-furthest-edge(2), 
left-of-galleys (3), 
right-of-galleys (4) 

} 


Figure B—57 illustrates the syntax used to create a function link construct. 


Refer to the description of the corresponding Function Computed Content 
Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-57: Function Link Syntax Diagram 


FunctionLink ::= SEQUENCE { 
function-name [0] IMPLICIT ASCIIString, 
function-parameters [1] IMPLICIT NamedValueList 


} 


Figure B—-58 illustrates the syntax used to create an external reference index 
construct. 


Refer to the description of the corresponding Copied and Remote Computed 
Content Attributes for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B—58: External Reference index Syntax Diagram 
ExternalRefIndex ::= INTEGER 


Figure B—59 illustrates the syntax used to create a language index construct. 


Refer to the description of the corresponding Language Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B-59: Language Index Syntax Diagram 


LanguageIndex ::= INTEGER 


Figure B-60 illustrates the syntax used to create a content definition construct. 


Refer to the description of the corresponding DDIF$_CTD aggregate and to the 
Content Definitions Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—60: Content Definition Syntax Diagram 


ContentDefn ::= SEQUENCE { 
content-label [0] IMPLICIT ContentDefnLabel, 
content-external [1] IMPLICIT Reference OPTIONAL, 
content-value [2] IMPLICIT Content OPTIONAL, 
content-private {3] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B-61 illustrates the syntax used to create a label types construct. 


Refer to the description of the corresponding DDIF$_CRF aggregate, the Variable 
Computed Content Attribute for the DDIF$_SGA aggregate, and to the 
DDIF$_TYD aggregate in Chapter 4. 


Figure B-61: Label Types Syntax Diagram 


VariableLabel ::= Label 
Segment Label ::= Label 
TypeDefnLabel ::= Label 
ContentDefnLabel ::= Label 
GalleyLabel ::= Label 
PageDescLabel ::= Label 
PageLayoutLabel :3:= Label 
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Figure B—62 illustrates the syntax used to create a label construct. 


Figure B-62: Label Syntax Diagram 


Label ::= ASCIIString 


Figure B-63 illustrates the syntax used to create an ASCII string construct. 
Figure B-63: ASCIl String Syntax Diagram 
ASCIIString ::= Latinl-String 

Figure B—64 illustrates the syntax used to create a variable label construct. 


Figure B-64: Variable Label Syntax Diagram 


VariableLabel ::= Label -- used to refer to variable by name 


Figure B—65 illustrates the syntax used to create a legend units construct. 


Refer to the description of the corresponding Legend Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—65: Legend Units Syntax Diagram 


LegendUnits ::= SEQUENCE { 
legend-unit [0] IMPLICIT Ratio, 
legend-unit-name [1] IMPLICIT Text-String 


} 


Figure B-66 illustrates the syntax used to create an angle construct. 


Refer to the description of the corresponding DDIF$_TRN aggregate, the Path- 
Based Layout Attribute, and to the Frame Content Transformation Attribute for 
the DDIF$_SGA aggregate in Chapter 4. 


Figure B-66: Angle Syntax Diagram 


Angle ::= FLOATING-POINT 


Figure B-67 illustrates the syntax used to create an AngleRef construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate and to the 
DDIF$_PTH aggregate in Chapter 4. 
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Figure B-67: AngleRef Syntax Diagram 


AngleRef ::= CHOICE { 
angle~-constant {0] IMPLICIT Angle, 
angle-variable {1] IMPLICIT VariableLabel 


} 


Figure B-68 illustrates the syntax used to create a measurement construct. 


Refer to the description of the corresponding DDIF$_PTH aggregate and to the 
- Frame Position Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-68: Measurement Syntax Diagram 


Measurement ::= CHOICE { 
integer-constant [0] IMPLICIT INTEGER, 
variable-measure [1] IMPLICIT VariableLabel 


} 


Figure B—69 illustrates the syntax used to create a position construct. 


Refer to the description of the corresponding Frame Bounding Box Attributes, the 
Frame Position Attribute, and to the Fixed Frame parameters for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—69: Position Syntax Diagram 


Position ::= SEQUENCE { 
x-coordinate [0] XCoordinate, 
y-coordinate [1] YCoordinate 


} 


Figure B-70 illustrates the syntax used to create a ratio construct. 


Refer to the description of the corresponding DDIF$_HRV aggregate and to the 
Line Attributes for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-70: Ratio Syntax Diagram 


Ratio ::= SEQUENCE { 
numerator {0} IMPLICIT INTEGER DEFAULT 1, 
denominator (1] IMPLICIT INTEGER DEFAULT 100 


} 


Figure B-71 illustrates the syntax used to create a right angle construct. 


Refer to the description of the corresponding Path-Based Layout Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—72 illustrates the syntax used to create a size construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate and to 
the Text Size Attribute, the Frame Position Attribute, and the Inline Frame 
Parameters for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B-71: Right Angle Syntax Diagram 


RightAngle ::= INTEGER { right(1), 
left (2), 
up (3), 
down (4) 


Figure B-72: Size Syntax Diagram 


Size ::= Measurement 


Figure B—78 illustrates the syntax used to create an x-coordinate construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate, the 
DDIF$_PTH aggregate, and to the Frame Position Attribute and the Fixed Frame 
Parameters for the DDIF$_SGA aggregate in Chapter 4. 
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Figure B-—73: X-Coordinate Syntax Diagram 
XCoordinate ::= Measurement 


Figure B-—74 illustrates the syntax used to create a y-coordinate construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate, the 
DDIF$_PTH aggregate, and to the Frame Position Attribute and the Fixed Frame 
Parameters for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-74: Y-Coordinate Syntax Diagram 


YCoordinate ::= Measurement 


Figure B-75 illustrates the syntax used to create a measurement units construct. 


Refer to the description of the corresponding Measurement Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—75: Measurement Units Syntax Diagram 


MeasurementUnits ::= SEQUENCE { 
units-per-measurement [0] IMPLICIT INTEGER, 
unit—name [1] IMPLICIT Text-String 


} 


Figure B—76 illustrates the syntax used to create a named value construct. 


Figure B~76: Named Value Syntax Diagram 


NamedValue ::= SEQUENCE { 
value-name NamedValueTag, 
value-data ValueData 


} 


Figure B—77 illustrates the syntax used to create a value data construct. 


Refer to the description of the DDIF$_PVT aggregate in Chapter 4. 
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Figure B-77: Value Data Syntax Diagram 


ValueData ::= CHOICE { 
value-boolean [0] IMPLICIT BOOLEAN, 
value-integer [1] IMPLICIT INTEGER, 
value-text [2] IMPLICIT Text-String, 
value-general [3] IMPLICIT OCTET STRING, 
value-reference [4] IMPLICIT Reference, 
value-list [5] IMPLICIT SEQUENCE OF ValueData, 
value-external {6] IMPLICIT EXTERNAL 


} 


Figure B—78 illustrates the syntax used to create a named value list construct. 


Refer to the description of the corresponding DDIF$_CTD aggregate, the 
DDIF$_FTD aggregate, the DDIF$_DHD aggregate, the DDIF$_IDU aggre- 
gate, the DDIF$_LG1 aggregate, the DDIF$_PGD aggregate, the DDIF$_PHD 
aggregate, the DDIF$_LSD aggregate, and to the DDIF$_TYD aggregate in 
Chapter 4. 


Figure B—78: Named Value List Syntax Diagram 


NamedValueList ::= SEQUENCE OF NamedValue 


Figure B-79 illustrates the syntax used to create a font number construct. 
Refer to the description of the corresponding Font Definitions Attribute and to 
the Text Font Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-79: Font Number Syntax Diagram 


FontNumber :3:= INTEGER 


Figure B—80 illustrates the syntax used to create a marker number construct. 


Figure B~80: Marker Number Syntax Diagram 


MarkerNumber ::= INTEGER 


Figure B-81 illustrates the syntax used to create a path number construct. 
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Figure B-81: Path Number Syntax Diagram 


PathNumber ::= INTEGER 


Refer to the description of the corresponding DDIF$_PTH aggregate in 
Chapter 4. 


Figure B-82 illustrates the syntax used to create a pattern number construct. 


Refer to the description of the corresponding Text Mask Pattern Attribute, the 
Line Attributes, and to the Marker Attributes for the DDIF$_SGA aggregate in 
Chapter 4. 


Figure B-82: Pattern Number Syntax Diagram 


PatternNumber ::= INTEGER 


Figure B—83 illustrates the syntax used to create a path definition construct. 


Refer to the description of the corresponding DDIF$_PHD aggregate and to the 
Path Definitions Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-83: Path Definition Syntax Diagram 


PathDefn ::= SEQUENCE { 
path-number (0] IMPLICIT PathNumber, 
path-description [1] IMPLICIT CompositePath, 
path-private {[2] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B-84 illustrates the syntax used to create a composite path construct. 


Refer to the description of the corresponding DDIF$_FAS aggregate, the 
DDIF$_GLY aggregate, the DDIF$_PHD aggregate, the DDIF$_PTH aggregate, 
and to the Frame Outline Attribute and Frame Clipping Attribute for the 
DDIF$_SGA aggregate in Chapter 4. 


Figure B—84: Composite Path Syntax Diagram 


CompositePath ::= SEQUENCE OF CHOICE { 
line-path-component [0] IMPLICIT PolyLinePath, 
cubic-path-component {1] IMPLICIT CubicBezierPath, 
arc-path-component _ [2] IMPLICIT ArcPath, 
path-reference [3] IMPLICIT PathNumber 


} 


Figure B-85 illustrates the syntax used to create an arc path construct. 


Refer to the description of the corresponding DDIF$_ARC aggregate and to the 
DDIF$_PTH aggregate in Chapter 4. 
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Figure B—85: Arc Path Syntax Diagram 


ArcPath ::= SEQUENCE { 
arc-center-x [0] XCoordinate, 
arc~center-y [1] YCoordinate, 
arc~radius-x [2] Size, 
arc-radius-—delta-y [3] Size DEFAULT { integer-constant 0 }, 
arc-start [4] AngleRef 
DEFAULT { angle-constant 0.0 }, 
arc-extent [5] AngleRef 
DEFAULT { angle-constant 360.0 }, 
arc-rotation {(6] AngleRef 


DEFAULT { angle-constant 0.0 } 


Figure B-86 illustrates the syntax used to create a cubic Bézier path construct. 


Refer to the description of the corresponding DDIF$_BEZ aggregate and to the 
DDIF$_PTH aggregate in Chapter 4. 


Figure B-86: Cubic Bézier Path Syntax Diagram 


CubicBezierPath ::= SEQUENCE OF Measurement 


Figure B—87 illustrates the syntax used to create a line definition construct. 


Refer to the description of the corresponding DDIF$_LSD aggregate and to the 
Line-Style Definitions Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-87: Line Definition Syntax Diagram 


LineDefn ::= SEQUENCE { 
line-style-number [0] IMPLICIT LineStyleNumber, 
line-style-pattern [1] IMPLICIT SEQUENCE OF INTEGER OPTIONAL, 
line-style-private [2] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B-88 illustrates the syntax used to create a polyline path construct. 


Refer to the description of the corresponding DDIF$_LIN aggregate and to the 
DDIF$_PTH aggregate in Chapter 4. 
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Figure B-—88: Polyline Path Syntax Diagram 


PolyLinePath ::= SEQUENCE OF Measurement 


Figure B—89 illustrates the syntax used to create a pattern definition construct. 


Refer to the description of the corresponding DDIF$_PTD aggregate and to the 
Pattern Definitions Attribute for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-89: Pattern Definition Syntax Diagram 


PatternDefn ::= SEQUENCE { 
pattern-number [0] IMPLICIT PatternNumber, 
pattern-defn CHOICE { 
solid-color [1] Color, 
std-pattern [2] IMPLICIT StandardPattern, 
raster-pattern [3] IMPLICIT ImageDataUnit 
}, 
pattern-private {4] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B—90 illustrates the syntax used to create a standard pattern construct. 


Refer to the description of the corresponding DDIF$_PTD aggregate in 
Chapter 4. 


Figure B-90: Standard Pattern Syntax Diagram 


StandardPattern ::= SEQUENCE { 
std-pattern-number [0] IMPLICIT INTEGER, 
pattern-colors [1] IMPLICIT SEQUENCE OF PatternNumber 


DEFAULT {INTEGER 1, INTEGER 2} 
} 


Figure B-91 illustrates the syntax used to create a reference construct. 


Refer to the description of the corresponding DDIF$_PVT aggregate and to the 
Copied and Remote Computed Content Attributes for the DDIF$_SGA aggregate 
in Chapter 4. 
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Figure B-91: Reference Syntax Diagram 
Reference ::= SEQUENCE { 
ref-target [0] IMPLICIT SegmentLabel OPTIONAL, 


[1] IMPLICIT ExternalRefIndex OPTIONAL 
} 


ref-x-index 


Figure B—92 illustrates the syntax used to create a segment attributes construct. 


Refer to the description of the corresponding DDIF$_SEG aggregate, the 
DDIF$_TYD aggregate, the DDIF$_SGA aggregate, and General Segment 
Attributes and Alternate Presentation Attribute for the DDIF$_SGA aggregate in 
Chapter 4. 


Figure B-92: Segment Attributes Syntax Diagram 


} 


Figure B—93 illustrates 


construct. 


SegmentAttributes ::= SEQUENCE { 
private-attributes [0] IMPLICIT NamedValueList OPTIONAL, 
content-—streams [1] IMPLICIT SEQUENCE OF StreamTag OPTIONAL, 
content-category [2] IMPLICIT CategoryTag OPTIONAL, 
segment-tags [3] IMPLICIT SEQUENCE OF SegmentTag OPTIONAL, 
segment—bindings [4] IMPLICIT SEQUENCE OF Binding OPTIONAL, 
computed-content [5] ComputeDefn OPTIONAL, 
structure-description [6] StructureDefn OPTIONAL, 
language [7] IMPLICIT LanguageIndex OPTIONAL, 
legend-units [8] IMPLICIT LegendUnits OPTIONAL, 
measurement-units [9] IMPLICIT MeasurementUnits OPTIONAL, 
alt-presentation [10] IMPLICIT Text-String OPTIONAL, 
layout-attributes {11] TextLayout OPTIONAL, 
font-definitions [12] IMPLICIT SEQUENCE OF FontDefn OPTIONAL, 
pattern-definitions [13] IMPLICIT SEQUENCE OF PatternDefn OPTIONAL, 
path-definitions [14] IMPLICIT SEQUENCE OF PathDefn OPTIONAL, 
line-style-definitions [15] IMPLICIT SEQUENCE OF LineDefn OPTIONAL, 
content-defns [16] IMPLICIT SEQUENCE OF ContentDefn OPTIONAL, 
segment-—type-defns [17] IMPLICIT SEQUENCE OF SegTypeDefn OPTIONAL, 
text-attributes [18] IMPLICIT TextAttributes OPTIONAL, 
line~-attributes [19] IMPLICIT LineAttributes OPTIONAL, 
marker-attributes [20] IMPLICIT MarkerAttributes OPTIONAL, 
galley-attributes [21] ANY OPTIONAL, 
image-attributes [22] IMPLICIT ImageAttributes OPTIONAL, 
frame-parameters {23} IMPLICIT FrameParameters OPTIONAL 


the syntax used to create a segment type definition 


Refer to the description of the corresponding Type Definitions Attribute for the 
DDIF$_SGA aggregate and to the DDIF$_TYD aggregate in Chapter 4. 


DDIF Syntax Diagrams B-33 


Figure B-93: Segment Type Definition Syntax Diagram 


SegTypeDefn ::= SEQUENCE { 
type-label [0] IMPLICIT TypeDefnLabel, 
type-parent [1] IMPLICIT TypeDefnLabel OPTIONAL, 
type-attributes [2] IMPLICIT SegmentAttributes OPTIONAL, 
type-private [3] IMPLICIT NamedValueList OPTIONAL 


} 


Figure B—94 illustrates the syntax used to create a structure definition construct. 


Refer to the description of the corresponding DDIF$_OCC aggregate and to the 
Structure Attributes for the DDIF$_SGA aggregate in Chapter 4. 


Figure B-94: Structure Definition Syntax Diagram 


StructureDefn ::= CHOICE { 
sequence-structure [0] IMPLICIT SEQUENCE OF OccurrenceDefn, 
set-structure {1] IMPLICIT SEQUENCE OF OccurrenceDefn, 
choice-structure [2] IMPLICIT SEQUENCE OF OccurrenceDefn 


} 


Figure B—95 illustrates the syntax used to create an occurrence definition con- 
struct. 


Refer to the description of the corresponding DDIF$_OCC aggregate in 
Chapter 4. 


Figure B-95: Occurrence Definition Syntax Diagram 


OccurrenceDefn ::= CHOICE { 
required-element {O] StructureElement, 
optional-element {1] StructureBlement, 
repeat-element [2] StructureElement, 
opt-repeat—element [3] StructureElement 


} 


Figure B-96 illustrates the syntax used to create a structure element construct. 


Refer to the description of the corresponding DDIF$_OCC aggregate in 
Chapter 4. 
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Figure B—96: Structure Element Syntax Diagram 


StructureElement ::= CHOICE { 


expression-element StructureDefn, 
referenced-type TypeDefnLabel 


} 


Figure B-97 illustrates the syntax used to create a tag construct. 


Figure B-97: Tag Syntax Diagram 


Tag ::= ASCIIString 


Figure B—98 illustrates the syntax used to create a category tag construct. 
Figure B-98: Category Tag Syntax Diagram 
CategoryTag :3:= Tag 

Figure B—99 illustrates the syntax used to create a conformance tag construct. 
Figure B~99: Conformance Tag Syntax Diagram 
ConformanceTag ::= Tag 

Figure B-100 illustrates the syntax used to create a named value tag construct. 
Figure B—100: Named Value Tag Syntax Diagram 


NamedValueTag ::= Tag 


Figure B—101 illustrates the syntax used to create a segment tag construct. 


Refer to the description of the corresponding Counter Variable Values for the 
DDIF$_SGB aggregate in Chapter 4. 
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Figure B—101: Segment Tag Syntax Diagram 


segmentTag 23= Tag 


Figure B-102 illustrates the syntax used to create a storage system tag 
construct. 


Figure B-102: Storage System Tag Syntax Diagram 


StorageSystemTag ::= Tag 


Figure B-103 illustrates the syntax used to create a stream tag construct. 


Figure B—103: Stream Tag Syntax Diagram 


StreamTag :3:= Tag . 


Figure B-104 illustrates the syntax used to create a transformation construct. 


Refer to the description of the corresponding DDIF$_CRF aggregate, the Frame 
Content Transformation Attribute for the DDIF$_SGA aggregate, and to the 
DDIF$_TRN aggregate in Chapter 4. 


Figure B—104: Transformation Syntax Diagram 


Transformation ::= SEQUENCE OF CHOICE { 
x-scale {O] IMPLICIT FLOATING-—POINT, 
y-scale [L] IMPLICIT FLOATING-POINT, 
x-translation [2] IMPLICIT FLOATING-POINT, 
y-translation [3] IMPLICIT FLOATING-POINT, 
xy-rotate [4] IMPLICIT Angle, 
xy-skew {5] IMPLICIT Angle, 
transform-2x3 [6] IMPLICIT SEQUENCE OF FLOATING-POINT, 
transform-3x3 {7] IMPLICIT SEQUENCE OF FLOATING-POINT 


} 


Figure B—105 illustrates the syntax used to create a variable binding construct. 


Refer to the description of the corresponding DDIF$_SGB aggregate and to the 
Counter Variable Values, Computed Variable Values, and to the List Variable 
Values for the DDIF$_SGB aggregate in Chapter 4. 
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Figure B—105: Variable Binding Syntax Diagram 


Binding ::= SEQUENCE { 
variable-name [0] IMPLICIT VariableLabel, 
variable-value CHOICE { 
counter-variable {1L] IMPLICIT CounterDefn, 
computed-variable [2] IMPLICIT StringExpression, 
list-variable {3] IMPLICIT RecordList 


} 


Figure B—106 illustrates the syntax used to create a counter definition construct. 


Refer to the description of the corresponding DDIF$_SGB aggregate and to the 
Counter Variable Values for the DDIF$_SGB aggregate in Chapter 4. 


Figure B-106: Counter Definition Syntax Diagram 


CounterDefn ::= SEQUENCE { 
counter-trigger CHOICE { 
counts-tagged-segments [0] IMPLICIT SegmentTag, 
counts-layout-objs [1] IMPLICIT LayoutObjectType 
} OPTIONAL, 
counter-init [2] Expression DEFAULT { exp-integer 1 }, 
counter-style (3] IMPLICIT SEQUENCE OF CounterStyle OPTIONAL, 
counter-type [4] IMPLICIT INTEGER { 
military (1), 
office(2), 
page-relative(3) } DEFAULT office 


Figure B—107 illustrates the syntax used to create a layout object type construct. 


Refer to the description of the corresponding Counter Variable Values for the 
DDIF$_SGB aggregate in Chapter 4. 


Figure B—107: Layout Object Type Syntax Diagram 


LayoutObjectType ::= INTEGER { document-layout-object (1), 
page-set-layout-object (2), 
page-layout-object (3), 
frame-layout-object (4), 
block-layout-object (5), 
line-layout-object (6) 
} 


Figure B-108 illustrates the syntax used to create an expression construct. 


Refer to the description of the corresponding Counter Variable Values for the 
DDIF$_SGB aggregate in Chapter 4. 
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Figure B-108: Expression Syntax Diagram 


Expression ::= CHOICE { 
exp-integer [0] IMPLICIT INTEGER, 
exp-variable [1] IMPLICIT VariableLabel 


} 


Figure B—109 illustrates the syntax used to create a counter style construct. 


Refer to the description of the corresponding DDIF$_CTS aggregate and to the 
Counter Variable Values for the DDIF$_SGB aggregate in Chapter 4. 


Figure B-109: Counter Style Syntax Diagram 


CounterStyle ::= CHOICE { 
number-style [0] IMPLICIT INTEGER { 
arabic(l), l-roman(2), 
u-roman(3), l-latin(4), 
u-latin(5), w-arabic(6), 


wl-roman(7), wu-roman (8), 
wl-latin(9), wu-latin(10), 
w-katakana-50 (11), 
w-katakana-iroha (12), 


hebrew (13) }, 
bullet-style [1] IMPLICIT SEQUENCE OF Character-String, 
style-separator [2] IMPLICIT Character-String 


} 


Figure B-110 illustrates the syntax used to create a string expression construct. 


Refer to the description of the corresponding DDIF$_SGB aggregate and to the 
Computed Variable Values for the DDIF$_SGB aggregate in Chapter 4. 


Figure B-110: String Expression Syntax Diagram 


StringExpression ::= SEQUENCE OF CHOICE { 
text-element [0] IMPLICIT Character-String, 
variable-ref-element [1] IMPLICIT VariableLabel 


} 


Figure B—111 illustrates the syntax used to create a record list construct. 


Refer to the description of the corresponding DDIF$_SGB aggregate and to the 
List Variable Values for the DDIF$_SGB aggregate in Chapter 4. 
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Figure B-111: Record List Syntax Diagram 


RecordList ::= SEQUENCE OF RecordDefn 


Figure B—112 illustrates the syntax used to create a record definition construct. 


Refer to the description of the corresponding DDIF$_RCD aggregate and to the 
List Variable Values for the DDIF$_SGB aggregate in Chapter 4. 


Figure B—112: Record Definition Syntax Diagram 


RecordDefn ::= SEQUENCE { 
record-type [0] IMPLICIT TypeDefnLabel, 
record-tag [1] IMPLICIT SegmentTag, 


record-contents [2] IMPLICIT SEQUENCE OF VariableLabel 
} ; 


Figure B-113 illustrates the syntax used to create a generic layout construct. 


Refer to the description of the corresponding DDIF$_LG1 aggregate in 
Chapter 4. 


Figure B-113: Generic Layout Syntax Diagram 


GenericLayout ::= [APPLICATION 31] IMPLICIT SEQUENCE { 
gl-private-data {0] IMPLICIT NamedValueList OPTIONAL, 
gl-page-descriptions [1] IMPLICIT SEQUENCE OF PageDescription 


} 


Figure B—114 illustrates the syntax used to create a page description construct. 


Refer to the description of the corresponding DDIF$_LG1 aggregate, the DDIF$_ 
LS1 aggregate, and to the DDIF$_PGD aggregate in Chapter 4. 


Figure B—114: Page Description Syntax Diagram 


PageDescription ::= SEQUENCE { 
pd-label [0] IMPLICIT PageDescLabel, 
pd-private-data [1] IMPLICIT NamedValueList OPTIONAL, 
. pd-desc CHOICE { 
page-set-desc {2] IMPLICIT PageSet, 
page-layout {3] IMPLICIT PageLayout 


} 


Figure B—115 illustrates the syntax used to create a page set construct. 


Refer to the description of the corresponding DDIF$_PGD aggregate and to the 
DDIF$_PGS aggregate in Chapter 4. 
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Figure B-115: Page Set Syntax Diagram 


PageSet ::= SEQUENCE OF PageSelect 
PageSelect ::= SEQUENCE { 
page-side-criteria [0] IMPLICIT INTEGER { 


left-page(1), 
right-page (2), 


either-page (3) } DEFAULT either-page, 
selected-page-layout CHOICE { 

select-by-label {1] IMPLICIT PageLayoutLabel, 

select—-by-defn {2] IMPLICIT PageLayout 


} 
} 


Figure B-116 illustrates the syntax used to create a page layout construct. 


Refer to the description of the corresponding DDIF$_PGD aggregate, the 
DDIF$_PGL aggregate, and to the DDIF$_PGS aggregate in Chapter 4. 


Figure B-116: Page Layout Syntax Diagram 


PageLayout ::= SEQUENCE { 
page-layout-id [0] IMPLICIT PageLayoutLabel, 
page-size [1] IMPLICIT GenSize, 
page-orientation [2] IMPLICIT INTEGER { 
portrait (1), 
landscape (2) } DEFAULT portrait, 
page-prototype [3] IMPLICIT PageLayoutLabel OPTIONAL, 
page-content [4] IMPLICIT PageFrame OPTIONAL 
} 
PageFrame ::=-Content -- Must be a frame 


Figure B-117 illustrates the syntax used to create a layout primitive construct. 


Figure B-117: Layout Primitive Syntax Diagram 


LayoutPrimitive ::= [APPLICATION 35] ANY 


Figure B-118 illustrates the syntax used to create a layout galley construct. 


Refer to the description of the corresponding DDIF$_GLY aggregate in 
Chapter 4. 
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Figure B-118: Layout Galley Syntax Diagram 


LayoutGalley ::= [APPLICATION 36] IMPLICIT SEQUENCE { 
galley-id [0] IMPLICIT GalleyLabel, 
galley-bounding-box [1] IMPLICIT BoundingBox, 
galley-outline [2] IMPLICIT CompositePath OPTIONAL, 
galley-flags [3] IMPLICIT BIT STRING { 


galley-vertical-align(0), 
galley-border (1), 
galley-autoconnect (2), 
galley-background-fill (3) 


} OPTIONAL, 
galley-streams [4] IMPLICIT SEQUENCE OF StreamTag OPTIONAL, 
galley-successor CHOICE { 

generic~galley [5] IMPLICIT GalleyLabel, 

specific-galley [6] IMPLICIT GalleyLabel, 

no-successor-galley {7] IMPLICIT NULL 


} 


Figure B—119 illustrates the syntax used to create a galley attributes construct. 


Refer to the description of the corresponding DDIF$_GLA aggregate and to the 
Galley Attributes for the DDIF$_SGA aggregate in Chapter 4. 


Figure B—119: Galley Attributes Syntax Diagram 


GalleyAttributes ::= [APPLICATION 37] IMPLICIT SEQUENCE { 
galley-top-margin [0] Measurement OPTIONAL, 
galley-left-margin [1] Measurement OPTIONAL, 
galley-right-margin [2] Measurement OPTIONAL, 
galley-bottom-margin [3] Measurement OPTIONAL 


} 


Figure B—120 illustrates the syntax used to create a specific layout construct. 


Refer to the description of the corresponding DDIF$_LS1 aggregate in Chapter 4. 


Figure B-120: Specific Layout Syntax Diagram 


SpecificLayout ::= [APPLICATION 32] IMPLICIT SEQUENCE OF CHOICE { 
specific-page [0] IMPLICIT PageDescription, 
referenced-page [1] IMPLICIT PageDescLabel 


} 


Figure B-121 illustrates the syntax used to create a wrap attributes construct. 


Refer to the description of the corresponding DDIF$_LW1 aggregate in 
Chapter 4. 
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Figure B—121: Wrap Attributes Syntax Diagram 


WrapAttributes ::= [APPLICATION 33] IMPLICIT SEQUENCE { 


wrap-format [OJ] IMPLICIT Format OPTIONAL, 
quad-format [1] IMPLICIT Format OPTIONAL, 
hyphenation-flags [2] IMPLICIT BIT STRING { 


hyphenation-allowed(0), 
paragraph-end(l1), 
galley-end(2), 


page-end(3), 

capitalized-word(4) } OPTIONAL, 
maximum-hyph-lines [3] IMPLICIT INTEGER OPTIONAL, 
maximum-orphan-size [4] IMPLICIT INTEGER OPTIONAL, 
maximum-widow-size [5] IMPLICIT INTEGER OPTIONAL 


Figure B-122 illustrates the syntax used to create a layout attributes construct. 


Refer to the description of the corresponding DDIF$_LL1 aggregate in Chapter 4. 


ra 


Figure B—122: Layout Attributes Syntax Diagram 


LayoutAttributes ::= [APPLICATION 34] IMPLICIT SEQUENCE { 
initial-directive [0] IMPLICIT Directive OPTIONAL, 
galley-select {1] IMPLICIT GalleyLabel OPTIONAL, 
break-before {2] IMPLICIT BreakCriteria OPTIONAL, 
break-within [3] IMPLICIT BreakCriteria OPTIONAL, 
break-after {4] IMPLICIT BreakCriteria OPTIONAL, 
initial-indent [5] Measurement OPTIONAL, 
left-indent [6] Measurement OPTIONAL, 
right-indent [7] Measurement OPTIONAL, 
space-before [8] Measurement OPTIONAL, 
space-after {9] Measurement OPTIONAL, 
leading [10] IMPLICIT Escapement OPTIONAL, 
tab-stops [11] IMPLICIT TabStopList OPTIONAL 


} 


Figure B-123 illustrates the syntax used to create a break criteria construct. 


Refer to the description of the corresponding DDIF$_LL1 aggregate in Chapter 4. 


Figure B-123: Break Criteria Syntax Diagram 


BreakCriteria ::= INTEGER { 
break-always (1), 
break-never (2), 
break-if—-needed (3) } 


Figure B—124 illustrates the syntax used to create a general measure construct. 


Refer to the description of the corresponding DDIF$_PGL aggregate in 
Chapter 4. 
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Figure B—124: General Measure Syntax Diagram 


GenMeasure ::= SEQUENCE { 
nominal-measure [0] Measurement DEFAULT { integer-constant 0 }, 
stretch-measure [1] Measurement DEFAULT { integer-constant 0 }, 
shrink-measure [2] Measurement DEFAULT { integer-constant 0 } 


} 


Figure B—125 illustrates the syntax used to create a general size construct. 


Refer to the description of the corresponding DDIF$_PGL aggregate in 
Chapter 4. 


Figure B—-125: General Size Syntax Diagram 


GenSize ::= SEQUENCE { 
x-size [0] IMPLICIT GenMeasure, 
y~-size [1] IMPLICIT GenMeasure 


F 


Figure B—126 illustrates the syntax used to create a tab stop list construct. 


Refer to the description of the corresponding DDIF$_LL1 aggregate in Chapter 4. 
‘Figure B-126: Tab Stop List Syntax Diagram 


TabStopList ::= SEQUENCE OF TabStop 


Figure B—127 illustrates the syntax used to create a tab stop construct. 


Refer to the description of the corresponding DDIF$_TBS aggregate in 
Chapter 4. 


Figure B-127: Tab Stop Syntax Diagram 


TabStop ::= SEQUENCE { 
horizontal-position [0] Measurement, 
tab-stop-type [1] IMPLICIT INTEGER { 


left-tab(1), 
center-tab(2), 


right~—tab (3), 
decimal-tab(4) } DEFAULT left-tab, 
tab-stop-leader [2] IMPLICIT Character-String OPTIONAL 


} 
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Figure B-128 illustrates the syntax used to create a generalized time construct. 


Refer to the description of the corresponding DDIF$_DHD aggregate in 
Chapter 4. 


Figure B-128: Generalized Time Diagram 


GeneralizedTime ::= [UNIVERSAL 24] IMPLICIT OCTET STRING 
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Appendix C 
DTIF Syntax Diagrams 





This appendix lists the syntax diagrams for each construct defined by DTIF 
(DIGITAL Table Interchange Format). The diagram for each construct is listed 
alphabetically under Syntax diagrams in the index. For example, Figure C—1 
shows the syntax used to create a DTIF document construct and is listed as 
DTIFDocument under Syntax diagrams in the index. For a description of the 
DDIS types referred to in the syntax diagrams, see Appendix B. 


Figure C—1 illustrates the syntax used to create a DTIF document construct. 


Refer to the description of the corresponding DTIF$_DTF aggregate in Chapter 5. 


Figure C-1: DTIF Document Syntax Diagram 


DTIFDocument ::= [PRIVATE 16382] IMPLICIT SEQUENCE { 
document~-descriptor [0] IMPLICIT DocumentDescriptor, 
document-—header {1] IMPLICIT DocumentHeader, 
document-tables {3] IMPLICIT SEQUENCE OF TableDefn 


} 


Figure C-2 illustrates the syntax used to create a document descriptor construct. 


Refer to the description of the corresponding DTIF$_DSC aggregate in Chapter 5. 


Figure C-2: Document Descriptor Syntax Diagram 


DocumentDescriptor ::= SEQUENCE { 
major-version {O0] IMPLICIT 
minor-version [1] IMPLICIT 
product-identifier [2] IMPLICIT 
product—name {3] IMPLICIT 
encode-major-version [4] IMPLICIT 
encode-minor-version [5] IMPLICIT 


} 


INTEGER, -- product version 
INTEGER, -- product version 
ASCIIString, 

Text-String, 

INTEGER, -- DTIF encoding version 
INTEGER -~ DTIF encoding version 
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Figure C-—3 illustrates the syntax used to create a document header construct. 


Refer to the description of the corresponding DTIF$_HDR aggregate in Chapter 5. 


Figure C-3: Document Header Syntax Diagram 


DocumentHeader ::= SEQUENCE { 
private-header-data [0] 
title [1] 
date [4] 
external-references [6] 
languages [7] 


iso-639-language 
other-language 


language-pref-tables [9] 
generic-columns [10] 


} 


IMPLICIT NamedValueList OPTIONAL, 
IMPLICIT Text-String OPTIONAL, 
IMPLICIT DateTime OPTIONAL, 
IMPLICIT SEQUENCE OF ExternalReference OPTIONAL, 
IMPLICIT SEQUENCE OF CHOICE { 
{O] IMPLICIT ASCIIString, 
[1] IMPLICIT Character-String 
} OPTIONAL, 
IMPLICIT SEQUENCE OF LangPrefTable OPTIONAL, 
IMPLICIT ColAttrList OPTIONAL 


Figure C—4 illustrates the syntax used to create an external reference construct. 


Refer to the description of the corresponding DTIF$_ERF aggregate in Chapter 5. 


Figure C-4: External Reference Syntax Diagram 


ExternalReference ::= SEQUENCE { 


reference-data-type 
reference-descriptor 
reference-label 
reference-label-type 
reference-control 
copy-reference 
no-copy-reference 
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[0] IMPLICIT OBJECT IDENTIFIER, 
[1] IMPLICIT Text-String, 
[2] IMPLICIT Character-String, 
[3] IMPLICIT StorageSystemTag, 
[4] IMPLICIT INTEGER { 
(Ly 
(2) 
} DEFAULT {copy-reference} 
} 


Figure C-5 illustrates the syntax used to create a storage system tag construct. 


Refer to the description of the corresponding DTI$_ERF aggregate in Chapter 5. 


Figure C-5: Storage System Tag Syntax Diagram 


StorageSystemTag ::= ASCIIString 


Figure C-—6 illustrates the syntax used to create an external references index 
construct. 


Refer to the description of the corresponding DTIF$_ERF aggregate in Chapter 5. 


Figure C-—6: External References Index Syntax Diagram 


ExternalRefIndex ::= INTEGER -- index into ExternalReferences 


Figure C-7 illustrates the syntax used to create a language preference table 
construct. 


Refer to the description of the corresponding DTIF$_LPT aggregate in Chapter 5. 


Figure C-7: Language Preference Table Syntax Diagram 


LangPrefTable ::= SEQUENCE { 
pref-language-index [0] IMPLICIT INTEGER OPTIONAL, 
pref-appl-priv [1] IMPLICIT ApplPrivate OPTIONAL, 
pref-items [2] IMPLICIT NamedValueList OPTIONAL, 
pref-editstrs [3] IMPLICIT SEQUENCE OF NamedEditString OPTIONAL, 
pref-collate-seq {4] IMPLICIT Latinl-String OPTIONAL, 
pref-collate-table [5] IMPLICIT OCTET STRING OPTIONAL 


} 
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Figure C-8 illustrates the syntax used to create a named edit string construct. 


Refer to the description of the corresponding DTIF$_NES aggregate in Chapter 5. 


Figure C-8: Named Edit String Syntax Diagram 


' NamedEditString ::= SEQUENCE { 
editstring-name [0] IMPLICIT ASCIIString OPTIONAL, 
editstring-defn [1] EditString 

} 


Figure C-9 illustrates the syntax used to create a table definition construct. 


Refer to the description of the corresponding DTIF$_TBL aggregate in Chapter 5. 


Figure C-9: Table Definition Syntax Diagram 


TableDefn ::= SEQUENCE { 
table-max-cols [0] IMPLICIT INTEGER OPTIONAL, 
table-max-rows [1] IMPLICIT INTEGER OPTIONAL, 
table-appl-private [2] IMPLICIT ApplPrivate OPTIONAL, 
table-metadata {3] IMPLICIT TableMD OPTIONAL, 
table-windows [4] IMPLICIT SEQUENCE OF WindowDefn OPTIONAL, 
table-rows {5] IMPLICIT SEQUENCE OF RowDefn OPTIONAL 


} 
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TableMD 


WindowDefn 


Figure C—10 illustrates the syntax used to create a table metadata construct. 


Refer the description of the corresponding DTIF$_ TMD aggregate in Chapter 5. 


tmd-name 

tmd-id 
tmd-appl-priv 
tmd-description 
tmd-flags 


tmd-default-fmts 
tmd-columns 
tmd-ranges 
tmd-symbols 


[0] 
[1] 
[2] 
[3] 
[4] 


[5] 


ee 
[8] 


:3:= SEQUENCE { 


IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


Figure C-10: Table Metadata Syntax Diagram 





Text-String OPTIONAL, 
INTEGER OPTIONAL, 

ApplPrivate OPTIONAL, 
Text-String OPTIONAL, 


BIT STRING { 
tmd-autorecalc (0), 
tmd-autoresort (1), 
tmd-calcbycol (2), 
tmd-calcbyrow (3), 
tmd-calcnatural (4), 
tmd-fmtbycol (5), 
tmd-fmtbyrow (6) 


} DEFAULT {tmd-fmtbycol}, 
FormatInfoList OPTIONAL, 
ColAttrList OPTIONAL, 

SEQUENCE OF RangeDefn OPTIONAL, 
NamedValueList OPTIONAL 





Figure C-11 illustrates the syntax used to create a table window construct. 


Refer to the description of the corresponding DTIF$_WND aggregate in 
Chapter 5. 


Figure C—11: Table Window Syntax Diagram 


wnd-name 

wnd-id 
wnd-appl-priv 
wnd=cardinal-num 
wnd-description 
wnd-flags 


wnd-formats 
wnd-ranges 
wnd-active-loc 


[0] 
[1] 
[2] 
[3] 
[4] 
[5] 


[6] 
[7] 
[8] 


::= SEQUENCE { 


IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


IMPLICIT 
IMPLICIT 
IMPLICIT 


Text-String OPTIONAL, 
INTEGER OPTIONAL, 
ApplPrivate OPTIONAL, 
INTEGER OPTIONAL, 


Text-String OPTIONAL, 

BIT STRING { 

window-active (0), 
window-hidden (1), 
window-formula-hidden (2), 
window-value-hidden (3), 
window-colhdr-hidden (4), 
window-rowhdr-hidden (5), 
window-lines-hidden (6) 


} DEFAULT {window-formula-hidden}, 
FormatiInfoList OPTIONAL, 

SEQUENCE OF RangeDefn OPTIONAL, 
CellCoord OPTIONAL 
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Figure C-12 illustrates the syntax used to create a table rows construct. 


Refer to the description of the corresponding DTIF$_ROW aggregate in Chapter 5. 


Figure C-12: Table Rows Syntax Diagram 


RowDefn ::= SEQUENCE { 

row-num [0] IMPLICIT RowNum OPTIONAL, 
row-appl-priv [1] IMPLICIT ApplPrivate OPTIONAL, 
row-formats ([2] IMPLICIT FormatInfoList OPTIONAL, 
row-flags {(3] IMPLICIT BIT STRING { 

row-annotation (0) 

} OPTIONAL, 
row-cells (4] IMPLICIT SEQUENCE OF CellData OPTIONAL 


} 





Figure C—13 illustrates the syntax used to create a cell data construct. 
Refer to the description of the corresponding DTIF$_CLD aggregate in Chapter 5. 


Figure C-13: Cell Data Syntax Diagram 


CellData ::= SEQUENCE { 

cell-col-num [0] IMPLICIT ColNum OPTIONAL, 

cell-state {1] IMPLICIT INTEGER { 
-- Basic cell states: 
cs-isvalue (0), 
ecs-isnull (1), 
cs-iserror (2), 
cs~isnovalue (3), 


~- Additional Error States. 

cs~isunderflow (10), 

cs-isoverflow (11), 

cs-isundefref (12), 

cs-isdivzero (13), 

cs-isrecursive (14) 

} DEFAULT {cs-isvalue}, 
cell-description [2] IMPLICIT Text-String OPTIONAL, 
cell-appl-priv [3] IMPLICIT ApplPrivate OPTIONAL 
cell-formats {4] IMPLICIT FormatInfoList OPTIONAL, 
cell-value [5] CellValue OPTIONAL, 
cell-formula-cfe [6] Expression OPTIONAL 
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Figure C-14: Cell Value Syntax Diagram 


Figure C-14 illustrates the syntax used to create a cell value construct. 


Refer to the description of the corresponding DTIF$_CLD aggregate in Chapter 5. 


CellValue ::= CHOICE 
cv-integer [0] 
ev-latinl-text {1] 
cv-simple-text [2] 
cv-date [3] 
cv-scaled-integer ies 
cv-vtext [6] 
cv-array [7] 
cv-complex [8] 
cv-float [9] 
cv-boolean [10] 


I 


{ 

IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


INTEGER, 
Latini-String, 
Character-String, 
DateTime, 
SCALED-INTEGER, 
VaryingText, 
ArrayDefn, 
ComplexFloat, 
FLOATING-POINT, 
BOOLEAN 


Figure C—15 illustrates the syntax used to create a varying text construct. 


Refer to the description of the corresponding DTIF$_VTX aggregate in 


Chapter 5. 


Figure C-15: Varying Text Syntax Diagram 


VaryingText 
vtext—-len 
vtext-str 


:= SEQUENCE { 


(O] IMPLICIT INTEGER, 
[1] IMPLICIT Character-String 


} 
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Figure C—16 illustrates the syntax used to create an array definition construct. 


Refer to the description of the corresponding DTIF$_ARD aggregate in Chapter 5. 


Figure C-16: Array Definition Syntax Diagram 


ArrayDefn ::= SEQUENCE { 
array-description [0] IMPLICIT Latinl-String OPTIONAL, 
array-elem-type-size [1] CHOICE { 

std-type [0] IMPLICIT INTEGER { 
elem-word (0), 
elem-long (1), 
elem-ffloat (2), 
elem-dfloat (3), 
elem-gfloat (4), 
elem-hfloat (5) 

}, 
var-type [1] IMPLICIT INTEGER 
}, 


array-x-dimension (2] IMPLICIT INTEGER, 
array-y-dimension {3] IMPLICIT INTEGER OPTIONAL, 
array-z-dimension [4] IMPLICIT INTEGER OPTIONAL, 
array-values [5] IMPLICIT OCTET STRING 


} 


Figure C-17 illustrates the syntax used to create a complex floating-point 
construct. 


Refer to the description of the corresponding DTIF$_CFT aggregate in Chapter 5, 
and to the CFE$_CFT aggregate and CFE$_EXL aggregate in Chapter 6 float 
construct. 


Figure C-17: Complex Float Syntax Diagram 


ComplexFloat ::= SEQUENCE 
{ 
real-part [0] IMPLICIT FLOATING-POINT, 
imaginary-part [1] IMPLICIT FLOATING-POINT 
} 
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Figure C—18 illustrates the syntax used to create a column attributes construct. 


Refer to the description of the corresponding DTIF$_CAT aggregate in Chapter 5. 


Figure C-18: Column Attributes Syntax Diagram 


ColAttrList ::= SEQUENCE OF ColAttributes 

ColAttributes ::= SEQUENCE { 
col-name {O] IMPLICIT ASCIIString OPTIONAL, 
col-id [1] IMPLICIT INTEGER OPTIONAL, 
col-appl-priv [2] IMPLICIT ApplPrivate OPTIONAL 
col-generic-ref {3] IMPLICIT INTEGER OPTIONAL, 


~- not used in generic~columns; 
-- used by table-col to reference generic col-id 


col-description [4] IMPLICIT Text-String OPTIONAL, 
col-formats {5] IMPLICIT FormatInfoList OPTIONAL, 
col-computed-by [6] Expression OPTIONAL, 
col-default-value [7] CellValue OPTIONAL, 
col-missing-value [8] CellValue OPTIONAL, 
col-query-name [9] IMPLICIT Character-String OPTIONAL, 
col-column-hdr [10] IMPLICIT Character-String OPTIONAL, 
col-data-type [12] IMPLICIT Datatype OPTIONAL, 
col-data-length [13] IMPLICIT INTEGER OPTIONAL, 
col-scale-factor {14] IMPLICIT INTEGER OPTIONAL, 
col-flags . [15] IMPLICIT BIT STRING { 
col-autorecalc (0), 
col-readonly (1), 
col-annotation (2) 
} OPTIONAL 
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Figure C—19 illustrates the syntax used to create a data type construct. 


Refer to the description of the corresponding DTIF$_CAT aggregate in Chapter 5. 


Figure C-19: Data Type Syntax Diagram 


Datatype ::= INTEGER { 
dt-unknown 
dt-word 
dt-long 
dt-quad 
dt-ffloat 
dt-dfloat 
dt-gfloat 
dt-hfloat 
dt-absdate 
dt-text 
dt-vtext 
dt-segstr 
} 


(0), 
(1), 
(2), 
(3), 
(4), 
(5), 
(6), 
(7), 
(8), 
(9), 
(10), 
(11) 


signed word integer (16 bits) 
signed longword integer (32 bits) 
signed quadword integer (64 bits) 


absolute date/time 
text string 

varying text string 
segmented string 


Figure C-—20 illustrates the syntax used to create a format information list 


construct. 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C-20: Format Info List Syntax Diagram 


FormatiInfoList ::= SEQUENCE OF FormatInfo 

FormatiInfo ::= SEQUENCE { 
format—window-id [0] IMPLICIT INTEGER OPTIONAL, 
format-type [1] FormatType OPTIONAL, 
format-flags {2] IMPLICIT FmtFlags OPTIONAL, 
format-width [3] IMPLICIT INTEGER OPTIONAL, 
format-lang-id [4] IMPLICIT LangPrefIndex OPTIONAL, 
format-—direction [5] IMPLICIT INTEGER { 

dir-opposite (0) 

} OPTIONAL, 
format-unit-desc [6] IMPLICIT Text-String OPTIONAL, 
format~alignment [7] IMPLICIT INTEGER { 

fmt—-left (0), 
fmt-center (1), 
fmt-right (2) 
} OPTIONAL, 
format—border [8] IMPLICIT BIT STRING { 


border-left 
border-nolef 
border-top 
border-notop 
border-right 
border-norig 


t 


ht 


border-bottom 


border-nobot 
} OPTIONAL 
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tom 


(0), 
(1), 
(2), 
(3), 
(4), 
(5), 
(6), 
(7) 


Figure C-—21 illustrates the syntax used to create a language preference index 
construct. 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C-21: Language Preference Index Syntax Diagram 


LangPrefindex ::= INTEGER -- into LangPrefTable 


Figure C—22 illustrates the syntax used to create a format type construct. 
Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C-22: Format Type Syntax Diagram 


FormatType ::= CHOICE { 
format-numeric [0] IMPLICIT SEQUENCE { 
numdatatype {O] IMPLICIT BIT STRING 
{ numtyp-all (0), 
numtyp-integer (1), 
numtyp-float (2) 
} DEFAULT { num-all }, 
numfmt {1] CHOICE { 
num-std-fmt {O] IMPLICIT NumericFmt, 
num-editstr {1] EditString, 
num-editstr-id [2] IMPLICIT EditStrindex 
}, 
numrndtrunc {2] IMPLICIT INTEGER 
{ round-display (0), 
truncate-display (1) 
} OPTIONAL 
hy 
format-text {1] CHOICE { 
textfmt [0] IMPLICIT TextFmt, 
textestr {1] EditString, 
textestrid [2] IMPLICIT EditStrindex 
}, 
format-date [2] CHOICE { 
datefmt {O] IMPLICIT DateFmt, 
dateestr [1] EditString, 
dateestrid [2] IMPLICIT EditStrindex 


} 
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Figure C-—23 illustrates the syntax used to create an edit string index construct. 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C-23: Edit String Index Syntax Diagram 


EditStrIndex ::= INTEGER -- index into pref-editstrs 


Figure C—24 illustrates the syntax used to create a numeric format type construct. 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C—-24: Numeric Format Type Syntax Diagram 


NumericFmt ::= SEQUENCE { 
numfimttype {O0] IMPLICIT INTEGER { 

numfmt-general (0), 
numfimt-integer (1), 
numfmt-fixedpt (2), 
numfimt-scientific (3), 
numfmt -money (4), 
numfmt—-comma (5), 
numfmt—-percent (6), 
numfmt—-phone | (7), 
numfmt—bar (8), 
numfmt—-text (9) 


} OPTIONAL, 
numimtprec [1] IMPLICIT FmtPrec OPTIONAL 
} 


Figure C—25 illustrates the syntax used to create a numeric format precision 
syntax diagram. 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 
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Figure C-25: Numeric Format Precision Syntax Diagram 


FmtPrec ::= SEQUENCE { 
IMPLICIT INTEGER OPTIONAL, 


fmtprecdigits [0] 
fmtprecfrac [1] IMPLICIT INTEGER OPTIONAL 
} 


Figure C—26 illustrates the syntax used to create a predefined text type construct 
Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5 


Figure C-26: Predefined Text Types Syntax Diagram 


TextFmt ::= SEQUENCE { 
textfimttype [0] IMPLICIT INTEGER { 
text~-phone (0), 
text-text (1), 
text-repeat (2) 
} OPTIONAL 


Figure C-27 illustrates the syntax used to create a predefined date type construct 


Refer to the description of the corresponding DTIF$_FMI aggregate in Chapter 5. 


Figure C-27: Predefined Date Types Syntax Diagram 


DateFmt ::= SEQUENCE { 
dateftmttype [0] IMPLICIT INTEGER { 
date-dateonly (0), 


date-timeonly (1), 
date-dateandtime (2) 
} OPTIONAL, 


datefmtorder [1] IMPLICIT INTEGER { 
dateorder-mdy (0), 


dateorder-dmy (1) 
} OPTIONAL 


DTIF Syntax Diagrams C-—13 


Figure C—28 illustrates the syntax used to create a format flags construct. 


Refer to the description of the corresponding DTIF$_FMI aggregate in 
Chapter 5. 


Figure C-28: Format Flags Syntax Diagram 


FmtFlags ::= BIT STRING { 
fmt—-readonly (0), 
fmt-noreadonly (1), 
fmt-bold (2), 
fmt—-nobold (3), 
fmt-italic (4), 
fmt-noitalic (5), 
fmt-underline (6), 
fmt—-nounderline (7), 
fmt-valuehidden (8), 
fmt -novaluehidden (9), 


fmt-formulahidden (10), 
fmt-noformulahidden (11), 
fmt-running (12), 
fmt-norunning (13) 


Figure C—29 illustrates the syntax used to create a date time construct. 


Refer to the description of the corresponding DTIF$_DAT aggregate in Chapter 5, 
to the CFE$_DAT aggregate and CFE$_EXL aggregate in Chapter 6 and to the 
ESF$_DAT aggregate in Chapter 7. 


Figure C-29: Date Time Syntax Diagram 


DateTime ::= SEQUENCE { 
datetime [0] IMPLICIT OCTET STRING, 
time-diff [1] CHOICE { 
UTC-time [0] IMPLICIT NULL, 


plus-diff [1] IMPLICIT OCTET STRING, 
neg-diff . [2] IMPLICIT OCTET STRING 
} OPTIONAL 
} 


Figure C-—30 illustrates the syntax used to create a date time construct. 


Figure C-30: Application Private Syntax Diagram 


ApplPrivate ::= NamedValueList 
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Figure C-31 illustrates the syntax used to create a named value list construct. 


Refer to the description of the corresponding DTIF$_NVL aggregate in Chapter 5 
and to the ESF$_NVL aggregate in Chapter 7. 


Figure C-31: Named Value List Syntax Diagram 


NamedValueList ::= SEQUENCE OF NamedValue 


NamedValue ::= SEQUENCE { 
value-name NamedValuetTag, 
value-data ValueData 


} 


Figure C—32 illustrates the syntax used to create a value data construct. 


Refer to the description of the corresponding DTIF$_NVL aggregate in Chapter 5. 


Figure C-32: Value Data Syntax Diagram 


ValueData ::= CHOICE { 
value-boolean [0] IMPLICIT BOOLEAN, 
value-integer [1] IMPLICIT INTEGER, 
value-text [2] IMPLICIT Text-String, 
value-general [3] IMPLICIT OCTET STRING, 
value-list [5] IMPLICIT SEQUENCE OF ValueData, 
value-external [6] IMPLICIT EXTERNAL,. 
value-float {7] IMPLICIT FLOATING-POINT, 
value-date [8] IMPLICIT DateTime, 
value-expr {9] Expression 


Figure C-33 illustrates the syntax used to create an ASCII string construct. 


Refer to the description of the corresponding DTIF$_CAT, DTIF$_DSC, DTIF$_ 
ERF, DTIF$_HDR, and DTIF$_NES aggregates in Chapter 5. 


Figure C-33: ASCII String Syntax Diagram 


ASCIIString ::= Latinl-String --- limited to ASCII character set 


DTIF Syntax Diagrams C-15 


Figure C-34 illustrates the syntax used to create a column number construct. 


Refer to the description of the corresponding DTIF$_CCD aggregate in Chapter 5 
and to the CFE$_EXL aggregate in Chapter 6. 


Figure C-34: Column Number Syntax Diagram 


ColNum ::= INTEGER 


Figure C-35 illustrates the syntax used to create a row number construct. 


Refer to the description of the corresponding DTIF$_CCD aggregate in Chapter 5 
and to the CFE$_EXL aggregate in Chapter 6. 


Figure C-35: Row Number Syntax Diagram 


RowNum ::= INTEGER 


Figure C-36 illustrates the syntax used to create a cell coordinates construct. 


Refer to the description of the corresponding DTIF$_CCD aggregate in Chapter 5 
and to the CFE$_CCD aggregate and CFE$_EXL aggregate in Chapter 6. 


Figure C-36: Cell Coordinates Syntax Diagram 


CellCoord ::= SEQUENCE { 

cell-row {[O] IMPLICIT RowNum, 

cell-column [1] IMPLICIT ColNun, 

cell-flags [2] IMPLICIT INTEGER { 
relrow-relcol (0), 
relrow-abscol (1), 
absrow-relcol (2), 
absrow-abscol (3) 
} DEFAULT {relrow~relcol} 
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Figure C~37 illustrates the syntax used to create a range definition construct. 


Refer to the description of the corresponding DTIF$_RNG aggregate in Chapter 5. 


Figure C-37: Range Definition Syntax Diagram 


RangeDefnList ::= SEQUENCE OF RangeDefn 
RangeDefn ::= SEQUENCE { 
range-name [0] IMPLICIT Text-String OPTIONAL, 
range-type {1] IMPLICIT INTEGER { 
rt-named-range (0), 
rt-view-range (1), 
rt-col-title (2), 
rt-row-title (3), 
rt-display-data (4), 
rt-data-range (5), 
rt-sort-range (6) 
} DEFAULT {rt-named-range}, 
range-region {2] IMPLICIT SEQUENCE OF Range OPTIONAL, 


range-sort-keynum (3] IMPLICIT INTEGER OPTIONAL 
} 


Figure C--38 illustrates the syntax used to create a range construct. 


Refer to the description of the corresponding DTIF$_RNG aggregate in Chapter 5. 


Figure C-38: Range Syntax Diagram 


Range ::= CHOICE { 
cell-range [0] IMPLICIT CellRange, 
row-range [1] IMPLICIT RowRange, 
col-range [2] IMPLICIT ColRange, 


named-range [3] IMPLICIT NamedRange 
} 
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Figure C-—39 illustrates the syntax used to create a cell range construct. 


Refer to the description of the corresponding DTIF$_CLR aggregate in Chapter 5 
and to the CFE$_EXL aggregate in Chapter 6. 


Figure C-39: Cell Range Syntax Diagram 


CellRange ::= SEQUENCE { 
range-begin [0] IMPLICIT CellCoord, 
range-end {1] IMPLICIT CellCoord OPTIONAL 


} 


Figure C—40 illustrates the syntax used to create a row range construct. 


Refer to the description of the corresponding DTIF$_RWR aggregate in Chapter 5 
and to the CFE$_EXL aggregate and CFE$_RWR aggregate in Chapter 6. 


Figure C-40: Row Range Syntax Diagram 


RowRange ::= SEQUENCE { 
row-begin [0] IMPLICIT RowNum, 
row-end [1] IMPLICIT RowNum OPTIONAL 


} 


Figure C-41 illustrates the syntax used to create a column range construct. 


Refer to the description of the corresponding DTIF$_COR aggregate in Chapter 5 
and to the CFE$_COR aggregate and CFE$_EXL aggregate in Chapter 6. 


Figure C-41: Column Range Syntax Diagram 


ColRange ::= SEQUENCE { 
col-begin [0] IMPLICIT ColNun, 
col-end (1] IMPLICIT ColNum OPTIONAL 


} 


Figure C—42 illustrates the syntax used to create a named range construct. 


Refer to the description of the corresponding DTIF$_NMR aggregate in Chapter 5 
and to the CFE$_EXL aggregate in Chapter 6. 


Figure C-42: Named Range Syntax Diagram 


NamedRange ::= Text-String 
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Appendix D 
CFE Syntax Diagrams 


This appendix lists the syntax diagrams for each construct defined by CFE 
(Canonical Form Expressions). The diagram for each construct is listed 
alphabetically under Syntax diagrams in the index. For example, Figure D-1 
shows the syntax used to create a CFE private expression and is listed as 
PrivateFuncExpr under Syntax diagrams in the index. For a description of the 
DDIS types referred to in the syntax diagrams, see Appendix B. 


Figure D—1 illustrates the syntax used to create a private function expression 
construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_PFE aggregate in Chapter 6. 


Figure D-1: Private Function Expression Syntax Diagram 


PrivateFuncExpr ::= SEQUENCE { 
pf-facility {O] IMPLICIT ASCIIString, 
pf-name [1] IMPLICIT ASCIIString, 
pf-reference-label {2] IMPLICIT ASCIIString OPTIONAL, 
pf-reference-label-type[3] IMPLICIT StorageSystemTag OPTIONAL, 
pf-return-type [4] IMPLICIT BIT STRING 
{ fncret-numeric (0), --- returns numeric value 
fncret-boolean (1), --- returns boolean value 
fnceret-date (2), ---~ returns date value 
fncret-text (3) --- returns text value 
} OPTIONAL, 
pf-params [5] IMPLICIT SEQUENCE OF NamedParameter OPTIONAL 


} 
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Figure D-2 illustrates the syntax used to create a storage system tag construct. 
Refer to the description of the corresponding CFE$_PFE aggregate in Chapter 6. 


Figure D-2: Storage System Tag Syntax Diagram 
StorageSystemTag ::= ASCIIString 


Figure D-3 illustrates the syntax used to create a named parameter construct. 


Refer to the description of the corresponding CFE$_NPM aggregate in Chapter 6. 


Figure D-3: Named Parameter Syntax Diagram 


NamedParameter ::= SEQUENCE { 
param-name [0] IMPLICIT Latinl-String OPTIONAL, 


param-value [1] IMPLICIT ExpressionList 
} 


Figure D—4 illustrates the syntax used to create an expression construct. 
Refer to the description of the corresponding CFE$_EXP aggregate in Chapter 6. 


Figure D-4: Expression Syntax Diagram 


Expression ::= [PRIVATE 16376] IMPLICIT SEQUENCE 
{ major-version [0] IMPLICIT INTEGER OPTIONAL, - omit within DTIF 
minor-version [1] IMPLICIT INTEGER OPTIONAL, - omit within DTIF 
expr-list [2] IMPLICIT ExpressionList 


} 
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Figure D-5 illustrates the syntax used to create an expression list construct. 


Refer to the description of the corresponding CFE$_CCD aggregate, CFE$_CFT 
aggregate, CFE$_CLR aggregate, CFE$_COR aggregate, CFE$_DAT aggregate, 
CFE$_EXL aggregate, CFE$_FRF aggregate, CFE$_PEX aggregate, CFE$_ 
PFE aggregate, CFE$_ RWR aggregate, CFE$_SLL aggregate, CFE$_STF aggre- 
gate, CFE$_STP aggregate, CFE$_TXC aggregate, and CFE$_VTX aggregate in 
Chapter 6. 


Figure D-5: Expression List Syntax Diagram 


ExpressionList ::= SEQUENCE OF ExprChoice 


ExprChoice ::= CHOICE 
{ 


-- Variables/Literals 


lit-integer [QO] IMPLICIT INTEGER, 
lit-float | [1] IMPLICIT FLOATING-POINT, 
lit-text [2] Text, 

lit-date [3] IMPLICIT DateTime, 


lit-scaled-integer [4] IMPLICIT SCALED-INTEGER, 
lit-complex-float [5]. IMPLICIT ComplexFloat, 


Llit-vtext [6] IMPLICIT VaryingText,  -- varying length text 
cell-coord {8] IMPLICIT CellCoord, -~- cell coordinate 
cell-range [9] IMPLICIT CellRange, -- cell range 
row-range [10] IMPLICIT RowRange, -- row range 
col-range [11] IMPLICIT ColRange, -- column range 
named-range {12] IMPLICIT NamedRange, -- named range 
col-num [13] IMPLICIT ColNum, -- column number 
row-num {14] IMPLICIT RowNum, -- column name 
col-name [15] IMPLICIT ASCIIString, 

current~-value {179] IMPLICIT NULL, 

identifier [180] Text, 


-- Functions: Listed in order of decreasing (perceived) frequency 


-- Arithmetic Functions 


negate {16] IMPLICIT ExpressionList, 
add [17] IMPLICIT ExpressionList, 
subtract. [18] IMPLICIT ExpressionList, 
divide (19] IMPLICIT ExpressionList, 
multiply [20] IMPLICIT ExpressionList, 
power [21] IMPLICIT ExpressionList, 
unary-plus [171] IMPLICIT ExpressionList, 
percent [172] IMPLICIT ExpressionList, 


(continued on next page) 
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Figure D-5 (Cont.): 


Expression List Syntax Diagram 


-- Boolean, Relational Expressions 


if-then-else [23] IMPLICIT 
not [24] IMPLICIT 
and {25] IMPLICIT 
or [26] IMPLICIT 
eql {27] IMPLICIT 
gtr {28] IMPLICIT 
geq [29] IMPLICIT 
iss {30] IMPLICIT 
leq [31] IMPLICIT 
neq [32] IMPLICIT 
between {33] IMPLICIT 
abs-value {34] IMPLICIT 
modulo {35] IMPLICIT 
sqrt {36] IMPLICIT 
-- Statistical Functions 

sum [37] IMPLICIT 
avg [38] IMPLICIT 
count {39] IMPLICIT 
min [40] IMPLICIT 
max {41] IMPLICIT 
stdev {42] IMPLICIT 
var {43] IMPLICIT 
-- Conversion Functions 

cvt-to-value [44] IMPLICIT 
round [45] IMPLICIT 
truncate [46] IMPLICIT 
int [47] IMPLICIT 
decimal-string {151] 


-- Identification Functions 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


SelectorList, 
SelectorList, 
SelectorList, 
SelectorList, 
SelectorList, 
SelectorList, 
SelectorList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


IMPLICIT DecimalString, 


iserror {48] IMPLICIT ExpressionList, 
isblank [49] IMPLICIT ExpressionList, 
isnull [50] IMPLICIT ExpressionList, 
isdate [51] IMPLICIT ExpressionList, 
isnumber {52] IMPLICIT ExpressionList, 
isstring [53] IMPLICIT ExpressionList, 
isref ([54] IMPLICIT ExpressionList, 
isnot-avail [173] IMPLICIT ExpressionList, 
isnot-calc [174] IMPLICIT ExpressionList, 
-- String Functions 
stxr-char {55] IMPLICIT ExpressionList, 
str-code [56] IMPLICIT ExpressionList, 
str-concat [57] IMPLICIT ExpressionList, 
str~-extract [58] IMPLICIT ExpressionList, 
str-find [59] IMPLICIT ExpressionList, 
str-fixed [60] IMPLICIT ExpressionList, 
str-format {61] IMPLICIT SEQUENCE 

{ source [0] IMPLICIT ExpressionList, 

edit-string [1] EditString 


hy 
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logical 
logical 
logical 


greater 
greater 
less th 
less th 
not equ 


absolut 
modulus 
square 


average 


minimum 
maximum 
standar 
varianc 


convert 


integer 


string 
string 
string 
string 
string 
string 
string 


NOT 
AND 
OR 


than 

than or equal to 
an 

an or equal to 

al to 


e value 


root 


dad deviation 
e 


to value 


character 
characater code 
concatenate 
extract 

find substring 
fixed 

format 
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str-left 
str-length 
str-lower 
str-pretty 


{ string-expr 
pretty-flags 


}, 


str-proper 
str-repeat 
str-replace 
str-reverse 
str-right 
str-trim 
str-upper 
contains 
starts 


{ 
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[62] IMPLICIT ExpressionList, 
[63] IMPLICIT ExpressionList, 
[64] IMPLICIT ExpressionList, 
(65] IMPLICIT SEQUENCE 
[0] IMPLICIT ExpressionList, 
{[1] IMPLICIT BIT STRING 
pretty-collapse (0), 
pretty-compress (1), 
pretty-lowercase (2), 
pretty-trim (3), 
pretty-—uncomment (4), 
pretty-upcase (5) } 
[66] IMPLICIT ExpressionList, 
[67] IMPLICIT ExpressionList, 
[68] IMPLICIT ExpressionList, 
[69] IMPLICIT ExpressionList, 
[70] IMPLICIT ExpressionList, 
[71] IMPLICIT ExpressionList, 
[72] IMPLICIT ExpressionList, 


[168] IMPLICIT ExpressionList, 
[170] IMPLICIT ExpressionList, 


-- Choose and Lookup Functions 


choose 
index 
vlookup 
hlookup 
table 
matches 
in-table 


[73] 
[74] 
[75] 
[76] 
[77] 


[169] IMPLICIT ExpressionList, 
[152] IMPLICIT ExpressionList, 


-- Date/Time Functions 


name-—day 
name-month 
name-daynum 


name-monthnum 


now 
today 
tomorrow 
yesterday 
ext-day 
ext-month 
ext-year 
ext-hour 
ext-minute 
ext-second 
diff-day 
adiff-week 
diff-month 


[78] 
[79] 
[80] 
[81] 
[82] 
[83] 
[84] 
[85] 
[86] 
[87] 
[88] 
[89] 
[90] 
[91] 
[92] 
[93] 
[94] 


IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 
IMPLICIT 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
NULL, 

NULL, 

NULL, 

NULL, 

ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


extract substring left. 
string length 

string lowercase 

string pretty 


string proper 

string repeat 

string replace 

string reverse 

extract substring right 
string trim 

string uppercase 
contains substring 
string starts with 


field in table 


date day of the week 
date month name 

day of the week 
month name 


date/time 
date/time 
date/time 
date/time 


extraction 
extraction 
extraction 
extraction 


date/time extraction 
date/time extraction 
date/difference 
date/difference 
date/difference 
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Figure D-5 (Cont.): 
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diff-year [95] IMPLICIT ExpressionList, -- date/difference 

diff-hour [96] IMPLICIT ExpressionList, -- date/difference 

diff-min [97] IMPLICIT ExpressionList, -- date/difference 

diff-sec [98] IMPLICIT ExpressionList, -- date/difference 

cvt—-to-date [99] IMPLICIT ExpressionList, -- convert string to date 

cvt-to-time [100] IMPLICIT ExpressionList, -- convert string to time 

plus-days [101] IMPLICIT ExpressionList, -- date/time addition 

plus-weeks [102] IMPLICIT ExpressionList, -- date/time addition 

plus~-months [103] IMPLICIT ExpressionList, -- date/time addition 

plus-years (104] IMPLICIT ExpressionList, -- date/time addition 

plus-hours [105] IMPLICIT ExpressionList, -- date/time addition 

plus-mins [106] IMPLICIT ExpressionList, -- date/time addition 

plus-secs [107] IMPLICIT ExpressionList, -- date/time addition 

-- Cell-Related Functions 

error [108] IMPLICIT NULL, 

null [109] IMPLICIT NULL, 

cur-row [110] IMPLICIT NULL, -- current row 

cur-col [111] IMPLICIT NULL, -- current column 

cur-cell [112] IMPLICIT NULL, -- current cell 

cell-row [113] IMPLICIT ExpressionList, -- cell row 

cell-col {114] IMPLICIT ExpressionList, -- cell column 

cell-name {115] IMPLICIT ExpressionList, -- cell name 

count-rows {116] IMPLICIT ExpressionList, -- count rows 

count-cols [117] IMPLICIT ExpressionList, -- count columns 

cell-extract [118] IMPLICIT ExpressionList, -- cell extract 

not-avail [175] IMPLICIT NULL, -- not available 

not-calc [176] IMPLICIT NULL, -- not calculable 

cell-indirect {177] IMPLICIT ExpressionList, -- cell indirect 

--~ Financial Functions 

apprec [119] IMPLICIT ExpressionList, -- appreciation 

dep-cross [120] IMPLICIT ExpressionList, -- depreciation, declining 
balance w/ crossover 
to straight line 

dep-db [121] IMPLICIT ExpressionList, -- depreciation, declining 
balance 

dep-ddb [122] IMPLICIT ExpressionList, -- depreciation, double 
declining balance 

dep-sline [123] IMPLICIT ExpressionList, -- depreciation, straight line 

dep-soyd [124] IMPLICIT ExpressionList, -- depreciation, sum of year’s 
digits 

discount [125] IMPLICIT ExpressionList, -- discount 

fv (126] IMPLICIT ExpressionList, -- future value 

fva {127] IMPLICIT ExpressionList, -- future value of an annuity 

fvpv {128] IMPLICIT ExpressionList, -- future value of a single sum 

interest {129] IMPLICIT ExpressionList, -- interest payments 

irr [130] IMPLICIT ExpressionList, -- internal rate of return 

mirr [131] IMPLICIT ExpressionList, -- modified internal rate of 
return 

npv [132] IMPLICIT ExpressionList, -- net present value 

payback {133] IMPLICIT ExpressionList, -- payback 

perpmt [134] IMPLICIT ExpressionList, -- number of periods to achieve 
future value 

perpv [135] IMPLICIT ExpressionList, -- number of periods given 
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present value 
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Figure D-5 (Cont.): 
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pmtpv [136] IMPLICIT 
pmt fv ([137] IMPLICIT 
principal [138] IMPLICIT 
pva [139] IMPLICIT 
pvfv [140] IMPLICIT 
rate [141] IMPLICIT 
perfv [178] IMPLICIT 
-- Series Functions 

logest {142] IMPLICIT 
lsqr {143} IMPLICIT 
integrate [144] IMPLICIT 
sigma [145] IMPLICIT 
trend [146] IMPLICIT 
-- Additional Constants 

lit-true [147] IMPLICIT 
lit-false {148] IMPLICIT 
lit-pi [149} IMPLICIT 
-- Miscellaneous Functions 
random-u [150] IMPLICIT 
sign [167] IMPLICIT 
parenthesized [7] IMPLICIT 
private-function [998] IMPLICIT 
field-reference [999] IMPLICIT 
-~ Trigonometric Functions 

sin [153] IMPLICIT 
cos {(154] IMPLICIT 
tan {155] IMPLICIT 
asin [156] IMPLICIT 
acos (157] IMPLICIT 
atan [158] IMPLICIT 
atan2 [159] IMPLICIT 


-- Transcendental Functions 


1ogi0 [160] IMPLICIT 
logn [161] IMPLICIT 
alog {162] IMPLICIT 
factorial [163] IMPLICIT 
exponent [22] IMPLICIT 
~~ Binary Functions 

asl. {164] IMPLICIT 
asr [165] IMPLICIT 
ones-cmp [166] IMPLICIT 
} -- End of ExprChoice CHOICE 


ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


-—- TRUE 
-- FALSE 
== Pid 


NULL, 
NULL, 
NULL, 


NULL, 
ExpressionList, 


ParenthesizedExpr, 


PrivateFuncExpr, 


FieldRef, 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 
ExpressionList, 


ExpressionList, 
ExpressionList, 
ExpressionList, 


payment per period given 
present value 

payment per period to achieve 
future value 

principal 

present value of an annuity 
present value to achieve 
future value 

interest rate 

periods to achieve future 
value 


logest 

least squares 
integrate 
sigma 

trend 


random number 

sign 

parenthesized expression 
-- private Function 

field Reference 


sine 

cosine 
tangent 

arc sine 

are cosine 
arc tangent 
arc tangent 2 


log, base 10 
log, base e 
antilog 
factorial 
exponent 


arithmetic shift left 
arithmetic shift right 
one’s complement 
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Figure D-6 illustrates the syntax used to create a text construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_TXC aggregate in Chapter 6. 


Figure D-6: Text Syntax Diagram 


Text ::= CHOICE { 

-latinl-text [0] IMPLICIT Latinl-String, 
simple-text [1] IMPLICIT Character-String, 
complex-text [2] IMPLICIT Text-String 

} ; 


Figure D-7 illustrates the syntax used to create a varying text construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_VTX aggregate in Chapter 6. 


Figure D-7: Varying Text Syntax Diagram 
VaryingText ::= DTIF.VaryingText 


Figure D-8 illustrates the syntax used to create a selector list construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_SLL aggregate in Chapter 6. 


Figure D-8: Selector List Syntax Diagram 


SelectorList ::= SEQUENCE 
{ criteria [0] IMPLICIT ExpressionList OPTIONAL, - defaults to TRUE 
selection [1] IMPLICIT ExpressionList 
} 
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Figure D-9 illustrates the syntax used to create a decimal string construct. 


Refer to the description of the corresponding CFE$_EXL aggregate in Chapter 6. 


Figure D-9: Decimal String Syntax Diagram 


DecimalString 


Figure D-10: 


EditString 


::= Latinl-String --- consisting of 0-9, ., +, - 


Figure D—10 illustrates the syntax used to create an edit string construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_STF aggregate in Chapter 6. 


Edit String Syntax Diagram 


::= ESF.EditString 


Figure D-11 illustrates the syntax used to create a parenthesized expression 
construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_PEX aggregate in Chapter 6. 


Figure D-11: Parenthesized Expressions Syntax Diagram 


ParenthesizedExpr ::= SEQUENCE { 
begin-expr [0] IMPLICIT Text-String OPTIONAL, 
value-expr [1] IMPLICIT ExpressionList, 
end-expr {2] IMPLICIT Text—-String OPTIONAL 
} 


Figure D—12 illustrates the syntax used to create a field reference construct. 


Refer to the description of the corresponding CFE$_EXL aggregate and to the 
CFE$_FRF aggregate in Chapter 6. 


Figure D-12: Field Reference Syntax Diagram 


FieldRef ::= SEQUENCE 
{ 
field-context [0] IMPLICIT ContextVariable OPTIONAL, 
field-path [1] IMPLICIT SEQUENCE OF Latinli-String 
} 


CFE Syntax Diagrams D-9 


Appendix E 
ESF Syntax Diagrams 


This appendix lists the syntax diagrams for each construct defined by ESF (Edit 
String Format). The diagram for each construct is listed alphabetically under 
Syntax diagrams in the index. For example, Figure E—1 shows the syntax used to 
create an ESF edit string and is listed as EditString under Syntax diagrams in 
the index. For a description of the DDIS types referred to in the syntax diagrams, 
see Appendix B. 


Figure E-1 illustrates the syntax used to create an edit string construct. 


Refer to the description of the corresponding ESF$_EDS aggregate in Chapter 7. 


Figure E-1: Edit String Syntax Diagram 


EditString ::= [PRIVATE 16375] IMPLICIT SEQUENCE 
{major-version [0] IMPLICIT INTEGER OPTIONAL, --- omit within DTIF | 
minor-version [1] IMPLICIT INTEGER OPTIONAL, --- omit within DTIF 
edit-string [2] IMPLICIT EditStrBuff 


} 


Figure E—2 illustrates the syntax used to create an edit string buffer construct. 


Refer to the description of the corresponding ESF$_EDS aggregate in Chapter 7. 


Figure E-2: Edit String Buffer Syntax Diagram 


EditStrBuff ::= SEQUENCE OF CHOICE 
{ single-tag Single, 
repeat-tag [0] IMPLICIT Repeat 


} 
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Figure E-3 illustrates the syntax used to create a single construct. 


Refer to the description of the corresponding ESF$_EDS aggregate and to the 
ESF$_TXT aggregate in Chapter 7. 


Figure E-3: Single Syntax Diagram 


Single ::= CHOICE { 
alphabetic {1] IMPLICIT NULL, 
am—-pm [2] IMPLICIT NULL, 
any-char [3] IMPLICIT NULL, 
any-case [4] IMPLICIT NULL, 
binary-digit [5] IMPLICIT NULL, 
digit-sep [6] IMPLICIT NULL, 
day-number {7] IMPLICIT NULL, 
decimal-digit {8] IMPLICIT NULL, 
radix-point [9] IMPLICIT NULL, 
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encoded-minus [10] IMPLICIT NULL, 
encoded-plus [11] IMPLICIT NULL, 
encoded-sign [12] IMPLICIT NULL, 
exponent {13] IMPLICIT NULL, 
zero-replace {14] IMPLICIT Text-String, 
currency [15] IMPLICIT NULL, 

minus [16] IMPLICIT NULL, 

plus [17] IMPLICIT NULL, 

sign [18] IMPLICIT NULL, 
float-blank-supr [19] IMPLICIT NULL, 
fraction-second [20] IMPLICIT NULL, 
hex-digit [21] IMPLICIT NULL, 
hour-12 {22] IMPLICIT NULL, 
hour~24 {23] IMPLICIT NULL, 
julian-digit [24] IMPLICIT NULL, 
logical~char [25] IMPLICIT NULL, 
long-text [26] IMPLICIT NULL, 
lowercase -(27] IMPLICIT NULL, | 
minus-—literal {28] IMPLICIT Text-String, 
minus-lit-end [29] IMPLICIT Text-String, 
minute {30] IMPLICIT NULL, 
month-name {31] IMPLICIT NULL, 
month-number {32] IMPLICIT NULL, 
octal-digit {33] IMPLICIT NULL, 
plus-literal [34] IMPLICIT Text-String, 
reverse {35] IMPLICIT NULL, 

second [36]. IMPLICIT NULL, 
str-literal {37] IMPLICIT Text-String, 
missing-sep [38] IMPLICIT NULL, 
uppercase [39] IMPLICIT NULL, 
weekdayname {40] IMPLICIT NULL, 

year {41] IMPLICIT NULL, 
appl-private [42] IMPLICIT ApplPrivate, 
digit-sep-lit [43] IMPLICIT Text-String, 
radix-point-lit [44] IMPLICIT Text-String, 
currency-lit [45] IMPLICIT Text-String 


Figure E-4 illustrates the syntax used to create a repeat construct. 


Refer to the description of the corresponding ESF$_EDS aggregate and to the 
ESF$_RPT aggregate in Chapter 7. 


Figure E-4: Repeat Syntax Diagram 


Repeat ::= SEQUENCE 
{ repeat-count [0] IMPLICIT INTEGER, 
repeat-seq Single 


} 


Figure E-5 illustrates the syntax used to create an application private construct. 


Refer to the description of the corresponding ESF$_EXT aggregate in Chapter 7. 


Figure E-5: Application Private Edit String Syntax Diagram 


ApplPrivate ::= NamedValueList 
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Appendix F 
VMS Support for CDA in DECwindows 


VMS commands and utilities, as well as existing application programs that accept 
text input, can now use the text content of DECwindows compound documents. 


To support the use of DDIF text, VMS RMS has implemented a new RMS file 

attribute, stored semantics, and a DDIF-to-Text RMS extension. The value of the 

stored semantics attribute is called the file tag; it specifies how file data is to 

be interpreted. When file data is to be interpreted in accordance with the DDIF 
_ specification, the appropriate file tag is DDIF. The use of file tags is limited to 

disk files on VMS DECwindows systems. 


The DDIF-to-Text RMS extension transparently extracts text from DDIF files 
as variable-length text records that can be accessed through the VMS RMS 
interface. 


The enhancements made to support the reading of text from DDIF files are 
transparent to the user and to the application programmer. This support requires 
that all DDIF files in a VMS DECwindows environment be tagged with the 
DDIF file tag. DDIF files created by VMS DECwindows software are tagged 
appropriately. 


Section F.1 describes various VMS file management commands and utilities 
that display, create, and preserve file tags where appropriate. Section F.1 also 
describes the way various VMS commands and utilities respond to DDIF file 
input. Section F.2 describes VMS support for DDIF files in heterogeneous 
computing environments. Section F.3 describes the changes made to the VMS 
RMS program interface to support the stored semantics attribute and to control 
access to the content of DDIF files. 


F.1 VMS Commands and Utilities 


This section describes the VMS commands and utilities that support tag 
maintenance by displaying, creating, and preserving the RMS file tags used with 
DDIF files. It also provides additional information that is relevant to the way 
selected VMS commands and utilities respond to DDIF file input. _ 


The following table lists the VMS commands and utilities that support tag 


maintenance: 

Command/Utility Tag Maintenance Function 
DIRECTORY/FULL Displays file tag 
ANALYZE/RMS_FILE Displays file tag 


SET FILE/SEMANTICS Creates file tag 
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Command/Utility Tag Maintenance Function 


VMS MAIL Preserves file tag? 
COPY Preserves file tag? 
BACKUP Preserves file tag 


1See text for exceptions. 


Tags are made up of binary values that can be up to 64 bytes long and can be 
expressed using hexadecimal notation. The hexadecimal value of the DDIF tag, 
for example, is 2B0C8773010301. VMS permits you to assign mnemonics to tag 
values so that DCL commands like DIRECTORY/FULL and VMS utilities like 
FDL and ANALYZE/RMS_FILE display a mnemonic for the DDIF tag instead of 
the hexadecimal value. The following DCL commands have been included in the 
system startup command file to assign the mnemonic DDIF to the hexadecimal 
value for a DDIF tag. 

$ DEFINE/TABLE=RMSSSEMANTIC_TAGS DDIF 2B0C8773010301 

$ DEFINE/TABLE=RMSS$SEMANTIC OBJECTS "2B0C8773010301" DDIF 

Using the appropriate DEFINE commands, you can assign mnemonics for other 
tags, including tags used with international program applications. 


F.1.1 Displaying RMS File Tags 


The DIRECTORY/FULL command and the Analyze/RMS_File Utility now display 
the RMS file tag for DDIF files. 


F.1.1.1| DIRECTORY/FULL 


Where applicable, the DIRECTORY/FULL command now provides the value of 
the stored semantics tag as part of the file information returned to the user. 
This is the recommended method for quickly determining whether or not a file is 
tagged. The following display illustrates how the DIRECTORY/FULL command 
returns the RMS attributes for a DDIF file named X.DDIF. 


X.DDIF;1 File ID: (767,20658,0) 


RMS attributes: Stored semantics: DDIF 


F.1.1.2 ANALYZE/RMS FILE 


When you use the ANALYZE/RMS_FILE command to analyze a DDIF file, the 
utility returns the file tag as an RMS file attribute. 


FILE HEADER 
File Spec: USERDS$: [TEST]X.DDIF;1 


Stored semantics: DDIF 
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One ANALYZE/RMS_FILE command option is to create an output FDL file that 
reflects the results of the analysis. 


$ ANALYZE/RMS FILE/FDL filespec 


When you use this option for analyzing a tagged file, the output FDL file includes 
the file tag as a secondary attribute to the FILE primary attribute. This is 
illlustrated in the following FDL file excerpt: 


IDENT " 9-JUN-1988 13:27:30 VMS/VMS ANALYZE/RMS_FILE Utility" 
SYSTEM 

SOURCE VMS 
FILE 

ALLOCATION 3 

STORED SEMANTICS SX’ 2B0C8773010301’ ! DDIF 


F.1.2 Creating RMS File Tags 


The CDA$CREATE_FILE routine in the Compound Document Architecture 
toolkit creates and tags DDIF files. However, you may encounter a DDIF file that 
was created without a file tag or a DDIF file whose file tag was not preserved 
during file processing. 


The DCL command SET FILE provides a new qualifier, /[NOJSEMANTICS, that 

permits you to tag a DDIF file through the DCL interface for VMS DECwindows 

systems. You can also use the qualifier to change a tag or to remove a tag from a 
file. 


The following command line tags the file X.DDIF as a DDIF file by assigning the 
appropriate value to the /SEMANTICS qualifier: 


§ SET FILE X.DDIF/SEMANTICS=DDIF 


See Section F.1 for information about how to use logical name tables to assign a 
mnemonic to a tag. 


A subsequent DIRECTORY/FULL command displays the following line as part of 
the file header: 


RMS attributes: Stored semantics: DDIF 


The next example illustrates how to use the SET FILE command to delete an 
RMS file tag: 


§ SET FILE X.DDIF/NOSEMANTICS 
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F.1.3 Preserving RMS File Tags and DDIF Semantics 


The COPY command and the VMS Mail Utility preserve RMS file tags and DDIF. 
semantics when you copy or mail a DDIF file on a VMS DECwindows system, 
except for conditions described in Section F.1.3.1 and Section F.1.3.2. 


The Backup Utility always preserves file tags and semantics when you back up a 
DDIF file to magnetic tape. 


F.1.3.1 COPY Command 


This section describes the results of using the COPY command with DDIF files 
for various operations. 


When you copy a DDIF file to a disk on a VMS DECwindows system using the 
COPY command, VMS RMS preserves the DDIF tag and the DDIF semantics of 
the input file in the output file. 


When you copy a DDIF file to a nondisk device on a VMS DECwindows system 
using the COPY command, VMS RMS does not preserve the DDIF tag or the 
DDIF semantics of the input file in the output file. Instead, VMS RMS writes the 
text from the input file to the output file as variable-length records. 


When you copy two or more DDIF and text files in any combination to a single 
output file, the output file takes the characteristics of the first input file, as shown 
in the following examples. 


1. In the first example, the first input file is a text file, so the output file 
(FOO.TXT) contains variable-length text records from X.TXT, Y.DDIF, and 
Z.TXT, but does not include the DDIF tag from Y.DDIF. 


S$ COPY X.TXT,Y.DDIF,4.TXT FOO.TXT 


2. In the next example, the first input file (A.DDIF) is a DDIF file, so the output 
file (FOO.DDIF) includes the DDIF tag as well as the DDIF semantics from 
A.DDIF. The attempt to copy the text input file (Z.TXT) fails because there 
is no Text-to-DDIF RMS extension, but the contents of B.DDIF and C.DDIF 
are copied to the output file. However, the output file has no practical use 
because, as a result of the way DDIF files are structured, only the data from 
the first input file (A.DDIF) is accessible in the output file. 


S$ COPY A.DDIF,B.DDIF,2Z.TXT,C.DDIF FOO.DDIF 


3. In the final example, the first input file (A.DDIF) is a DDIF file, so the output 
file (FOO.DDIF) includes the DDIF tag as well as the contents of A.DDIF. 
FOO.DDIF also includes the contents of B.DDIF and C.DDIF. Again, however, 
the output file has no practical use because, as a result of the way DDIF files 
are structured, only the data from the first input file (A.DDIF) is accessible in 
the output file. 


$§ COPY A.DDIF,B.DDIF,C.DDIF FOO.DDIF 


F.1.3.2 VMS Mail Utility 


The VMS Mail Utility preserves the DDIF file tag when DDIF files are mailed be- 
tween systems running VMS DECwindows. The VMS Mail Utility also preserves 
the DDIF file tag when you create an output file on a VMS DECwindows system 

using the EXTRACT command. 
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When you read a mail message that is a DDIF file, the VMS Mail Utility outputs 
only the text portion of the file. Similarly, if you edit a DDIF mail file, you can 
access only the file text; the output file is a text file that can no longer be used as 
a DDIF file. However, if you forward a message that consists of a DDIF file, the 
VMS Mail Utility sends the entire DDIF file, including DDIF semantics and the 
DDIF tag, to the addressee. 


F.1.4 APPEND Command 


This section describes what happens when you attempt to use the APPEND 
command in conjunction with DDIF and text files. 


In the first example, the APPEND command appends a DDIF file to a text file: 
$ APPEND X.DDIF Y.TXT 


The output file, Y TXT, contains its original text records as well as text from the 
input file, X.DDIF, reformatted as variable-length text records. 


In the next example, the APPEND command ePPEMGS a DDIF file to another 
DDIF file: 


S$ APPEND X.DDIF Y.DDIF 


The output file, Y DDIF, contains the DDIF tag, the original contents of Y.DDIF, 
and the contents of X.DDIF. However, the portion of the file that contains X.DDIF 
is not accessible because of the way DDIF files are structured. 


In the final example, the APPEND command attempts to append a text file to a 
DDIF file: 


S$ APPEND X.TXT Y.DDIF 


This append operation fails because there is no Text-to-DDIF RMS extension. 


F.2 DDIF Support in a Heterogeneous Environment 


This section describes the implementation of DDIF support in two heterogeneous 
environments. The first heterogeneous environment includes VMS DECwindows 
systems and non-VMS systems. The second heterogeneous environment includes 
VMS DECwindows systems and VMS systems that do not support VMS 
DECwindows. 


F.2.1 EXCHANGE/NETWORK Command 


A new DCL command, EXCHANGE/NETWORK, has been created to support the 
transfer of files between VMS systems and non-VMS systems that do not support 
VMS file types. The EXCHANGE/NETWORK command transfers files in either 
record mode or block mode but can only be used when both systems support 
DECnet file transfers. 
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To interactively tag a DDIF file and transfer the file between a non-VMS operat- 
ing system and a VMS system running DECwindows, do the following: 


1. Create the following file, assigning it the name DDIF.FDL: 


FILE 
ORGANIZATION sequential 
STORED SEMANTICS DDIF 
RECORD 
CARRIAGE CONTROL none 
FORMAT fixed 
SIZE S12 


2. Use the following DCL command to transfer the desired file: 


$ EXCHANGE/NETWORK/TRANSFER_MODE=block/FDL=DDIF.FDL input_filespec output_filespec 


F.2.2 Using the COPY Command in a Heterogeneous Environment 


If you use the COPY command to copy tagged DDIF files to systems other than 
VMS DECwindows systems, the results will vary depending on the target system: 


e If the target system is a non-VMS system, the file is copied, but the DDIF tag 
is not preserved. 


e If the target system is a VMS system that does not support VMS 
DECwindows, the copy operation fails. 


F.2.3 VMS Mail Utility in a Heterogeneous Environment 


If you try to send mail messages containing DDIF files to non-VMS systems that 
do not support tagged files, the VMS Mail Utility returns the NOACCEPTMSG 
error message, indicating that the remote node cannot accept the message format. 


Similarly, the VMS Mail Utility does not support the mailing of DDIF files to 
VMS systems that do not support VMS DECwindows. As with non-VMS systems, 
the VMS Mail Utility returns the NOACCEPTMSG error message, indicating 
that the remote node cannot accept the message format. 


F.3 VMS RMS Interface Changes 


This section provides details about the changes made to the VMS RMS interface 
that support access to text in VMS DECwindows DDIF files. It includes 
information related to tagging files and accessing tagged files through the VMS 
RMS interface. The section also describes how tags are preserved at the VMS 
RMS interface. 


F.3.1 Programming Interface for File Tagging 


This appendix focuses on the use of the DDIF tag for supporting VMS 
DECwindows files, although VMS RMS also supports file tagging for other 
compound document data formats. 


You can tag a file from the VMS RMS interface by using the $CREATE service 
in conjunction with a new extended attribute block (XAB) called the item XAB 
($XABITM). The $XABITM macro is a general-purpose macro that was added to 
the RMS interface to support several Version 5.0 features. Tagged file support 
involves the use of the two item codes shown in Table F-1. 
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Format 


Table F-1: Tag Support Item Codes 


Item Buffer Size Function 

XAB$ STORED_SEMANTICS 64 bytes maximum __ Defines the file semantics 
established when the file is 
created 

XAB$_ACCESS_SEMANTICS 64 bytes maximum ___ Defines the file semantics 
desired by the accessing 
program 


The entries XAB$_ STORED SEMANTICS and XAB$.ACCESS_SEMANTICS 

in the item list can represent either a control (set) function or a monitor (sense) 
function that can be passed to VMS RMS from the ee program by way of 
the RMS interface. 


The symbolic value XAB$K_SEMANTICS_MAX_LEN represents the tag length. 
This value may be used to allocate buffer space for sensing and setting stored 
semantics for the DDIF file. 


Within any one $XABITM, you can activate either the set function or the sense 
function for the XAB$_STORED_SEMANTICS and XAB$_ACCESS_SEMANTICS 
items, because a common field (XAB$B_MODE) determines which function is 
active. If you want to activate both the set function and the sense function for 
either or both items, you must use two $XABITM control blocks, one for setting 
the functions and one for sensing the functions. 


Each entry in the item list addressed by the $XABITM is made up of three 
longwords, and a longword 0 terminates the list. You can locate the item list 
anywhere within the readable address space for a process, but any buffers 
required by the related function must be located in read/write memory. If the 
item list is invalid, RMS returns a status of RMS$_XAB in the RAB$L_STS field 
and the address of the XAB in RAB$L_STV. 


The format and arguments of the $XABITM macro are as follows. Note that 
the block length field and the type code field are statically initialized by the 
$XABITM macro, or may be explicitly initialized using a high-level language. 


$XABITM /TEMLIST=item-list-address, 


MODE= { sensemode } 
setmode ‘ 


NXT=next-xab-address 
Arguments 


The ITEMLIST argument defaults to 0 but a valid pointer must be specified when 
you use a XABITM. MODE defaults to sensemode. The symbolic offset, size, and 
a brief description of each XABITM field are described in the following list: 


¢ The block length field KAB$B_BLN) is a 1-byte static field that defines the 
length of the XABITM, in bytes. This field is initialized to the value XAB$C_ 
ITMLEN. 


¢ The type code (XAB$B_COD) field is a 1-byte static field that identifies this 
control block as a XABITM. This field is initialized to the value XAB$C_ITM. 
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¢ The XAB$L_ITEMLIST field is a longword field that contains the symbolic 
address of the item list. 


¢ The XAB$B_MODE field is a 1-byte field that specifies whether or not the 
items can be set by the program. It contains either the symbolic value 
XAB$K_SETMODE or the symbolic value XAB$K_SENSEMODE (default). 


e The XAB$L_NXT field is a longword field that contains the symbolic address 
of the next XAB in the XAB chain. A value of 0 (the default) indicates that 
the current XAB is the last (or only) XAB in the chain. 


F-8 VMS Support for CDA in DECwindows 


Example F-1 illustrates a BLISS—32 program that tags a file through the RMS 
interface. The tag value shown is a 6-byte hexadecimal number representing 
the code for the DDIF tag. The VMS RMS program interface accepts only 


hexadecimal tag values. 


To write to a tagged file without using an RMS extension, the application program — 
must specify access semantics that match the file’s stored semantics. As shown 
in the example, the $CREATE service tags the file and the $CONNECT service 
specifies the appropriate access semantics. 


Example F-1: Tagging a File 


MODULE TYPESMAIN ( 
IDENT = ‘’X-1', 
MAIN = MAIN, 
ADDRESSING MODE (EXTERNAL=GENERAL) 
) = 

BEGIN 

{ 

FORWARD ROUTINE 

MAIN : NOVALUE; 

t 

! INCLUDE FILES: 

! 


LIBRARY ’SYSSLIBRARY:LIB’; 


! Main routine 


OWN 
NAM SNAM(), 
RETLEN, 
DDIF_TAG : BLOCK[ 7, BYTE] 
INITIAL ( BYTE( %X’2B’, %SX‘'0OC’, %X'87" SX'73", SX'01’', 
3X'03’, %SX'01’)), 
FAB XABITM ; 
S$xabitm 
( itemlist= 


SITMLST_UPLIT 
( 


(ITMCOD=XAB$_STORED SEMANTICS, 
BUFADR=DDIF_TAG, 
BUFSIZ=SALLOCATION (DDIF_TAG) ) 


), 


mode = SETMODE), 
RAB XABITM : 
Sxabitm 
( itemlist= 


SITMLST_UPLIT 
( 


(ITMCOD=XAB$ ACCESS SEMANTICS, 
BUFADR=DDIF_TAG, 
BUFSIZ=SALLOCATION (DDIF_TAG) ) 


), 


mode = SETMODE), 


(continued on next page) 
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Example F—1 (Cont.): Tagging a File 


FAB : SFAB( fnm = ’TAGGED-FILE.TEST’, 
nam = NAM, 
mrs = 512, - 
rim = FIX, 
fac = <GET,PUT,UPD>, 
xab = FAB | XABITM) , 
REC : BLOCK[512,BYTE], 
STATUS, 
RAB : SRAB( xab = RAB XABITM, 
fab = FAB, 
rsz = 512, 
rbf = REC, 
usz = 512, 
ubf = REC), 
DESC ; BLOCK[8,BYTE] INITIAL (0); 


ROUTINE MAIN : NOVALUE = 
BEGIN 
STATUS = SCREATE( FAB = FAB ); 
IF NOT .STATUS 
THEN 
SIGNAL (.STATUS); 
STATUS = SCONNECT( RAB = RAB ); 
IF NOT .STATUS 
THEN 
SIGNAL (.STATUS); 
STATUS = SCLOSE( FAB = FAB ); 
IF NOT .STATUS 
THEN 
SIGNAL (.STATUS); 
END; 
END 
ELUDOM 


F.3.2 Accessing a Tagged File 


This section provides details of how VMS RMS handles access to tagged files 

at the program level. When a program accesses a tagged file). VMS RMS must 
determine whether and when to associate an RMS extension with the access. 
This is important to the programmer because an RMS extension may change the 


attributes of the accessed file. 


For example, a DDIF file is stored as a sequentially organized file having 512- 
byte, fixed-length records. If the DDIF-to-Text RMS extension is used to extract 
text data from a DDIF file, the accessed file appears as a sequentially organized 


file having variable-length records with an implicit carriage return. 


One consideration in determining whether an access requires the RMS extension 
is the type of access (FAB$B_FAC). When an application program opens a file 
through the VMS RMS program interface, it must specify whether it will be doing 
record I/O (default), block I/O (BIO), or mixed I/O (BRO), where the program has 
the option of using either block I/O or record I/O for each access. For example, 

if block I/O operations are specified, VMS RMS does not associate the RMS 


extension with the file access. 
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Another consideration is whether the program senses the tag when it opens a file. 
If the program does not sense the tag when it opens a DDIF file for record access, 
VMS RMS associates the RMS extension during the $OPEN and returns the file 
attributes that have been modified by the extension. 


The final consideration is the access semantics the program specifies and the 
file’s stored semantics (tag). If the program specifies block I/O (FAB$V_BIO) 
operations, RMS does not associate the RMS extension and the $OPEN service 
returns the file’s stored attributes to the accessing program regardless of whether 
the program senses tags. 


F.3.2.1_ File Accesses That Do Not Sense Tags 


This section describes what happens when a program does not use the XABITM 
to sense a tag when it opens a file. 


When a program opens a DDIF file for record operations and does not sense the 
tag, VMS RMS assumes that the program wants to access text data in the file. In 
this case, VMS RMS associates the RMS extension, which provides file attributes 
that correspond to record-mode access. 


When a program opens a DDIF file with the FAB$V_BRO option and does not 
sense the tag, any subsequent attempt to use block I/O fails. If the program 
specifies block I/O (FAB$V_BIO) when it invokes the $CONNECT service, the 
operation fails because the file attributes returned at $OPEN permit record 
access only. Similarly, if the program specifies the FAB$V_BRO option when it 
opens the file, and then specifies mixed mode (block/record) operations by not 
specifying RAB$V_BIO at $CONNECT time, block operations such as READ and 
WRITE are disallowed. 


F.3.2.2 File Accesses That Sense Tags 


VMS RMS does not associate the RMS extension as part of the $OPEN service 
if a program opens a DDIF file and senses the stored semantics. This allows the 
program to specify access semantics with the $CONNECT service. VMS RMS 
returns the file attributes, including the stored semantics attribute (tag value), to 
the program as part of the $OPEN service. 


When the program subsequently invokes the $CONNECT service, VMS RMS uses 
the specified operations mode to determine its response. If the program specified 
FAB$V_BRO with the $OPEN service and then specifies block I/O (RAB$V_BIO) 
when it invokes the $CONNECT service, VMS RMS does not associate the RMS 
extension. 


But if the program specifies record access or FAB$V_BRO when it opens the 

file and then decides to use record I/O when it invokes the $CONNECT service, 
VMS RMS compares the access semantics with the file’s stored semantics to 
determine whether to associate the RMS extension. If the access semantics 
match the stored semantics, VMS RMS does not associate the RMS extension. If 
the access semantics do not match the stored semantics, VMS RMS associates 
the access with the RMS extension. In this case, the program must use the 
$DISPLAY service to obtain the modified file attributes. If VMS RMS cannot find 
the appropriate RMS extension, the operation fails and the $CONNECT service 
returns the EXTNOTFOU error message. 


If the application program senses the file’s stored semantics, VMS RMS allows 
mixed-mode operations. In this case, mixed block and record operations are 
permitted because the application gets record mode file attributes and data from 
the RMS extension and block mode file attributes and data from the file. 
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Example F-2 illustrates a BLISS—32 program that accesses a tagged file from an 
_ application program that does not use an RMS extension. 


Example F-2: Accessing a Tagged File 


MODULE TYPESMAIN ( 
IDENT = ’X-l1’, 
MAIN = MAIN, 
ADDRESSING MODE (EXTERNAL=GENERAL) 
) = 
BEGIN 
i] 
FORWARD ROUTINE 
MAIN : NOVALUE; ! Main routine 
! 
! INCLUDE FILES: 
if 


LIBRARY ’SYSSLIBRARY: STARLET’ ; 


OWN 
NAM : SNAM () t : 
ITEM BUFF : BLOCK[ XABSK_SEMANTICS MAX LEN, BYTE I, 
RETLEN, 
FAB XABITM : 
Sxabitm 
( itemlist= 


SITMLST _UPLIT 
( (ITMCOD=XABS_STORED_SEMANTICS, 
BUFADR=ITEM_BUFF, 
BUFSIZ=XABSK_SEMANTICS MAX LEN, 
RETLEN=RETLEN) ), 
mode = SENSEMODE), 


RAB ITEMLIST : BLOCK[ ITMSS ITEM + 4, BYTE ], 
RAB XABITM : SXABITM 
( itemlist=RAB ITEMLIST, 
mode=SETMODE ), 


FAB : SFAB( fnm = ’TAGGED-FILE.TEST’, 
nam = NAM, 
fac = <GET,PUT,UPD>, 
xab = FAB XABITM), 
REC : BLOCK[512,BYTE], 
STATUS, 
RAB : SRAB( xab = RAB XABITM, 
fab = FAB, 
rsz = 512, 
rbf = REC, 
usz = 512, 
ubf = REC), 


DESC : BLOCK[8,BYTE] INITIAL(0); 


(continued on next page) 
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Example F—2 (Cont.): Accessing a Tagged File 


ROUTINE MAIN : NOVALUE = 
BEGIN 
STATUS = SOPEN( FAB = FAB ); 
IF NOT .STATUS 
THEN 

SIGNAL (.STATUS) ; 
RAB _ITEMLIST[{ ITMSW_BUFSIZ ] 
RAB ITEMLIST[ ITMS$L BUFADR ] 
RAB ITEMLIST[ ITMSW_ITMCOD ] 
STATUS = SCONNECT( RAB = RAB ); 
IF NOT .STATUS 
THEN 

SIGNAL (.STATUS) ; 
STATUS = SCLOSE( FAB = FAB ); 
IF NOT .STATUS 
THEN 

SIGNAL (.STATUS) ; 
END; 
END 
ELUDOM 


.RETLEN; 
ITEM BUFF; 
XAB$ ACCESS SEMANTICS; 


F.3.3 Preserving Tags 


In order to preserve the integrity of a tagged file that is being copied or transmit- 
ted, the tag must be preserved in the destination (output) file. The most efficient 
way to use the RMS interface for propagating tags is to open the source file 
(input) and sense the tag using a $XABITM with the item code XAB$_STORED_ 
SEMANTICS: 


ITEMLIST[ ITMSW_BUFSIZ ] 
ITEMLIST[ ITMS$L BUFADR ] 
ITEMLIST[ ITM$L_RETLEN ] 
ITEMLIST[ ITMSW_ITMCOD ] 


XAB$K_SEMANTICS MAX LEN; 
ITEM BUFF; 

RETLEN; 

XAB$ STORED SEMANTICS; 


XABITM[ XAB$B_MODE ] = XABS$K_SENSEMODE; 
STATUS = SOPEN( FAB = FAB ); 


Then create the destination (output) file and set the tag using a $XABITM with 
the item code XAB$_STORED_SEMANTICS: 


IF .RETLEN GTR 0 
THEN 
BEGIN 
ITEMLIST[ ITMSW_ITMCOD ]J XABS$ STORED SEMANTICS; 
ITEMLIST[ ITMSL_ SIZE ] - RETLEN; 
XABITM[ XABSB_ MODE ] = XAB$K_SETMODE; 
END; 
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STATUS = S$CREATE( FAB = FAB ); 


END; 
END 
ELUDOM 


F.4 Distributed File System Support for DDIF Tagged Files 


Version 1.1 of the Distributed File System (DFS) includes limited support 

for DDIF tagged files. You can create and read DDIF files on a DFS device 
when the DFS client node is running VMS DECwindows. You can also use the 
DIRECTORY/FULL command to determine whether or not a DDIF file on a DFS 
device is tagged. 


You cannot use the SET FILE/[NOJSEMANTICS command either to tag DDIF 
files or to remove the tags from DDIF files on a DFS device. Furthermore, the 
Backup Utility does not preserve the DDIF tag or the DDIF stored semantics for 
data files on a DFS device. 


F.5 VMS RMS Errors 


Four VMS RMS error messages signal the user when the appropriate error 
condition exists: 


¢ RMS$_EXTNOTFOU 
¢ RMS$_SEMANTICS 
¢ RMS$_EXT_ERR 

¢ RMS$_OPNOTSUP 


The RMS$_EXTNOTFOU error message indicates that VMS RMS has not found 
the specified RMS extension. Verify that the file is correctly tagged, using the 
DIRECTORY/FULL command, and that the application program is specifying the 
appropriate access semantics. 


‘VMS RMS returns the RMS$_SEMANTICS error message when you try to create 
a tagged file on a remote VMS system that does not support VMS DECwindows 
from a system that does support VMS DECwindows. 


VMS RMS returns the RMS$_EXT_ERR error when the DDIF RMS extension 
detects an inconsistency. 


VMS RMS returns the RMS$_OPNOTSUP error when the RMS DDIF extension 

is invoked by an RMS operation. For example, if the extension does not support 

write access to a DDIF file, verify that the application program is not performing 
record operations that modify the file. 
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Appendix G 
CDAS$ Facility Messages 


This appendix lists the CDA$_ facility messages generated by the CDA Toolkit. 
A brief explanation and recommended user action follows each message, unless 
a user action is not required. The messages are listed in alphabetical order, by 
message name. 


ALLOCFAIL, memory allocation failure 
Level: Error 


Explanation: The standard memory allocation procedure failed to 
allocate dynamic memory. 


CLOSEFAIL, close failure 
Level: Error 


Explanation: The standard close function has failed. 


DCVNOTFND, domain converter not found 
Level: Error 


Explanation: The required domain converter could not be found. 


DEFAULT, item present by default 
Level: Success 


Explanation: The application called CDA$LOCATE_ITEM, which 
determined that the item was present by default in the input stream. 


DEFNOTFOU, definition not found 
Level: Error | 


Explanation: The application called CDA$FIND_DEFINITION refer- 
encing an entity that is not defined. 


EMPTY, empty item 
Level: Error 


Explanation: The application called a CDA access procedure referenc- 
ing an item that is empty. 


ENDOFDOC, end of document 
Level: Error 


Explanation: The application called CDA$GET_AGGREGATE, which 
determined that no more aggregates exist in the document. 
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ENDOFSEQ, end of sequence 
Level: Error 


Explanation: The application called CDA$NEXT_AGGREGATE refer- 
encing an aggregate that was at the end of a sequence. 


ERRINPLOG, error messages produced during 
input conversion, see error log 


Level: Error 


Explanation: The input conversion did not complete and some error 
messages were produced. 


User Action: Refer to the error log for more details. 


ERROUTLOG, error messages produced during 
output conversion, see error log 


Level: Error 


Explanation: The output conversion did not complete and some error 
messages were produced. 


User Action: Refer to the error log for more details. 


FLTTRN, floating-point truncation 
Level: Error 
Explanation: During CDA$LOCATE_ITEM for a general floating-point 
value, floating truncation occurred. 
ICVNOTFND, input converter not found 
Level: Error 


Explanation: The specified input converter could not be found. 


INDEX, index out of range 
Level: Error 


Explanation: The application called CDA$LOCATE_ITEM, CDA$STORE_ 
ITEM, or CDA$ERASE_ITEM referencing an array-valued item, but the 
index is out of range. 


INFINPLOG, informational messages produced during 
input conversion, see error log 
Level: Informational 


Explanation: The input conversion completed but some informational 
messages were produced. 


User Action: Refer to the error log for more details. 


INFOUTLOG, informational messages produced during 
output conversion, see error log 


Level: Informational 


Explanation: The output conversion completed but some informational 
messages were produced. 


User Action: Refer to the error log for more details. 


G-2 CDA$ Facility Messages 


INHERIT, item present by inheritance 
Level: Success 


Explanation: The application called CDA$LOCATE_ITEM, which 
determined that the item was present by inheritance in the input 
stream. 


INTERR, internal error 
Level: Fatal 
Explanation: The CDA Toolkit detected an internal error. 


INVADDINF, invalid additional information 
Level: Error 
Explanation: The add-info parameter in a call to CDA$LOCATE_ITEM 
or CDA$STORE_ITEM is invalid. 
INVAGGTYP, invalid aggregate type 
Level: Error 


Explanation: The application called a CDA access procedure referenc- 
ing an aggregate type code that is undefined, or an aggregate that has 
an undefined type code. 

INVBUFLEN, invalid buffer length 
Level: Error 
Explanation: The application called CDA$_STORE_ITEM referencing 
an item that is required to have a specified buffer length. The value of 
the buffer length parameter is not the required value. 

INVDATLEN, invalid data length 
Level: Error 
Explanation: The length of the value data exceeded the specified length 
for the data type. 

INVDOC, invalid document syntax 
Level: Error 
Explanation: The CDA access procedures determined that the docu- 
ment contains invalid syntax. 

INVFLTVAL, invalid floating-point value 
Level: Error 


Explanation: A floating-point datum has a reserved value. 


INVFUNCOD, invalid function code 
Level: Error 


Explanation: The application called CDA$CONVERT with an invalid 
function code. 
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INVINPDMN, invalid input domain 
Level: Error 


Explanation: An invalid input domain was specified for the front end. 
Only DDIF and DTIF are supported as domains. 


INVINSERT, invalid insert 
Level: Error 


Explanation: The application called CDA$INSERT_AGGREGATE or 
CDA$STORE_ITEM referencing an aggregate that was already part of a 
sequence, but was not the first aggregate of the sequence. 


INVITMCOD, invalid item code 
Level: Error 


Explanation: The application called a CDA access procedure referenc- 
ing an aggregate item code that is not defined. 


INVITMLST, invalid item list 
Level: Error 


Explanation: The application called CDA$OPEN_FILE or CDA$CREATE_ 
ROOT_AGGREGATE with a processing options item list that contained 
an invalid item. 


INVOPTION, invalid converter option 
Level: Error 
Explanation: An invalid option was specified for the converter. 


User Action: Refer to the documentation for this converter to see the 
valid options. 


INVOUTDMN, invalid output domain 
Level: Error 


Explanation: An invalid output domain was specified for the back end. 
Only DDIF and DTIF are supported as domains. 


INVSCOCOD, invalid scope code 
Level: Error 


Explanation: The application called CDA$ENTER_SCOPE or 
CDA$LEAVE_SCOPE referencing a scope code that is not defined or 
invalid in following correct document scoping rules. 

INVSCOTRAN, invalid scope transition 
Level: Error 


Explanation: The application made a call to CDA$ENTER_SCOPE or 
CDA$LEAVE_SCOPE that did not follow correct scoping rules. 


INVTAGCOD, invalid tag code 
Level: Error 


Explanation: The application called CDA$_STORE_ITEM referencing 
an item that has a special tag encoding, but the value of the add-info 
parameter is not defined for the item. 


G-4 CDA$ Facility Messages 


NORMAL, normal successful completion 
Level: Success 


Explanation: The specified action has been successfully completed. 


OCVNOTFND, output converter not found 
Level: Error 


Explanation: The specified output converter could not be found. 


OPENFAIL, open failure 
Level: Error 


Explanation: The standard open function has failed. 
READFAIL, read failure 


Level: Error 


Explanation: The standard read function has failed. 


READONLY, aggregate is read-only 
Level: Error 
Explanation: The application requested input processing options that 
require an aggregate to be read-only. The application attempted to write 
or delete the aggregate. 

SUSPEND, converter is suspended 
Level: Success 
Explanation: The application called CDA$CONVERT, which deter- 
mined that the back end suspended conversion. This message can only 
be returned by the CDA viewer. 

UNSUPCNV, unsupported document conversion 
Level: Error 
Explanation: The input and output document formats are incompatible 
for conversion. 

UNSUPFMT, unsupported document format 
Level: Error 


Explanation: The application called CDA$CONVERT with an unsup- 
ported document format name. The document format name may be 
misspelled, or the required conversion module may not be installed. 


VAREMPTY, empty variant item 
Level: Error 


Explanation: The application called CDA$LOCATE_ITEM, CDA$STORE_ 
ITEM, or CDA$ERASE_ITEM referencing an item that has a variable 
data type. The item that specifies the data type is empty. 
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VARINDEX, variant index out of range 
Level: Error 


Explanation: The application called CDA$LOCATE_ITEM, CDA$STORE_ 
ITEM, or CDA$ERASE_ITEM referencing an array-valued item that has 

a variable data type, but the index is out of range for the item that 
specifies the data type. 


VARVALUE, variant value out of range 
Level: Error 


Explanation: The application called CDA$LOCATE_ITEM, CDA$STORE_ 
ITEM, or CDA$ERASE_ITEM referencing an item that has a variable 
data type, but the item that specifies the data type has an invalid value. 


VERSKEW, major version skew between 
input file and CDA Toolkit 


Level: Error 


Explanation: The file’s major version is different from the Toolkit’s. 
Thus, the Toolkit cannot properly process the file. 


WRITFAIL, write failure 
Level: Error 


Explanation: The standard write function has failed. 
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Glossary of Terms 


This glossary alphabetically lists and defines terminology associated with the 
CDA architecture, data structures, and routines. 


add-info 


Additional information. This is a parameter to the LOCATE ITEM and 
STORE ITEM routines. 


aggregate 
An in-memory structure that is used to pass compound document data 
between the application and the CDA Toolkit routines. An aggregate 
corresponds to a manageable unit of the compound document. Aggregates 
are typed and self-describing; the type of an aggregate is indicated by a 
symbolic constant. An aggregate can be a member of an aggregate sequence, 
which can be traversed from beginning to end. Aggregates are defined for 
such objects as document roots, document descriptors, document headers, 
document segments, text content, and so on. 


AngleRef enumeration 


A compound document data type that is an enumeration specifying the data 
type of an item of DDIF type AngleRef, which is encoded as a floating-point 
or string value. 


arc 
A graphics object representing a circle or piece of a circle. 


attribute 


A term used to describe content characteristics such as font, line thickness, 
and color. 


back end 


A CDA application that converts a document from DDIF or DTIF format into 
a document in another format, such as PostScript or plain text. 


bit string 
A compound document data type that is encoded as a string of bits. The 
length of the item is expressed in bits. 


BMU 
Basic Measuring Unit. A BMU is 1/1200 of an inch. 


Boolean 


A compound document data type, encoded as a byte, that represents a 
Boolean value, which is always either True or False. 
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byte 
A compound document data type that is encoded as 8-bits of storage. The 
term “octet” is also used to describe an 8-bit byte. 


calling format 


A calling format is the interface specification for a routine. The calling format 
describes how the routine is to be called by other routines. The specification 
includes the routine’s name or address, and all of the routine’s parameters. 


CDA 


Compound Document Architecture. An architecture for interchanging 
complex and simple data in a computer architecture independent manner. 


CFE 


Canonical Form Expressions. A CDA format for defining revisable expressions 
at the cell or column level within a DTIF document. 


character string 


A compound document data type that is encoded as a string of bytes in a 
particular character set. 


compound document 


A unified collection of data that can be edited, formatted, or otherwise 
processed as a document. 


computed content 
Document content (most often text content) that is calculated based on the 
current formatting state or other inclusion of external data. For example, 
page numbers are often stored as computed content. 


- condition value 


An error that causes normal processing to stop is called a condition. The 
condition value identifies the error that caused processing to stop. 


content 
The class of data that makes up the fundamental units of documents. 
Document content includes text, graphics, raster images, and so on. The 
standard content aggregates are the basic units of content. 


content reference 


A shorthand notation for the phrase “reference to generic content.” A content 
reference is a relationship in a revisable document that defines the situation 
in which a content reference causes the generic content to be inserted into the 
final form when the document is formatted. 


content tag 


CDA content is uniquely identified by the context it appears in and a tag. For 
example, the tag for DDIF Latin1 text content is DDIF$_TXT. 


converter 


A CDA application that converts data to or from a CDA format. See also, 
front end, back end, base system converter, and third-party converter. 


DDIF 
Digital Document Interchange Format. A CDA format that can be used to 
interchange simple or complex documents containing text, images, and/or 
graphics. 


DDIS 
Digital Data Interchange Syntax. A method of encoding data for machine- 
independent interchange. DDIS is a subset of the International Standards 
Organization Open Systems Interconnect ASN.1 transfer syntax. 


DTIF 


Digital Table Interchange Format. A CDA format that can be used to 
interchange simple or complex spreadsheet data. 


document 
An entire hierarchical structure in memory, created by the CDA Toolkit 
routines. 


document content 
See content. 


document segment 
See segment. 


enumeration 
Assigns names to numbers or bits. Enumeration is a compound document 
data type that is encoded as a longword integer. An item that is encoded as 
an enumeration must specify the possible values for the enumeration. If the 
item following the enumeration item is of DDIF type variable, then the value 
selected for the enumeration item affects the encoding of the subsequent 
item. 


ESF 
Edit String Format. A CDA format for defining revisable, user-defined 
edit strings that define specialized display formats for numeric, text, and 
date/time data values. 


expression enumeration 
A compound document data type that is an enumeration that specifies the 
data type of an item of DDIF type expression. 


final form 7 
Stage of a document in which all the formatting decisions (such as 
hyphenation, line breaks, and page breaks) have been resolved. Final form 
documents are generally not revisable/editable. 


floating-point . 
See general floating-point and single-precision floating-point. 


formatting 
The process of fixing text in galleys. Formatting involves. breaking the stream 
of characters and floating frames into lines that fit within the assigned 
galleys. Formatting can also involve optimization of page layouts, the 
selection of appropriate page templates, and hyphenation decisions. 


frame 
A DDIF frame specifies a region in a document. The frame region may be 
anchored to a particular place in a document, or it may be associated with a 
section of text. Content within the frame is positioned relative to the frame. 
Graphics and image content must always be contained in a frame of the 
appropriate content category. 
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front end converter 


A CDA application that converts a document or data from a particular format 
to a CDA format. For example, the WK1 front end converts Lotus 1-2-3 
spreadsheets to DTIF format. 


galley 


A rectangular guide, such as a column or footnote area. DDIF galleys are 
modeled by areas that are filled with text and relocatable illustrations during 
the formatting process. 


galley-based layout 


In galley-based layout, characters and frames flow through a set of connected 
galleys and across pages instead of being fixed with respect to a coordinate 
system. 


general floating-point 
A floating-point value for which the format is specified by the add-in 
parameter. Upon storing a floating-point value, the CDA Toolkit transforms 
the value to a generic DDIS H-floating-point value. During a call to the 
LOCATE ITEM routine, an application specifies whether the DDIS-encoded 
floating-point data should be converted to VAX or IEEE format by the CDA 
Toolkit. 


generic attributes 


A relationship in a revisable document that defines attributes that can be 
applied to a number of segments, as opposed to being associated with a single 
segment. 


generic content 


A relationship in a revisable document that defines document content that 
can be included in multiple places in the document. 


generic layout 
A set of rules that are used to determine the layout of a document or set of 
documents. 


generic type 


A relationship in a revisable document that defines a set of attributes and 
processing tags that define a type. Elements of the document can reference 
a defined type and become an instance of the type, thus inheriting the 
attributes and processing characteristics of the generic type. 


GKS 
Graphical Kernel System. A standard way of specifying graphics objects. 


graphics content 
Content that consists of primitives such as arcs, polylines, and filled areas. 


handle 
The identifier of an aggregate, stream, file, front end, or back end. 


hard content 
Content that is entered by the creator of the document. 


image content 


Content that consists of digitized images represented by actual values of 
monochrome, grey-level, or color pixels. 


inheritance 
A relationship in a revisable document that defines a method for defaulting 
the attributes of content so that each segment of content does not need to 
specify all its attributes. Instead, each segment inherits the attributes of 
the surrounding segment, and specifies only the differences between the 
attributes of its content and those of the surrounding content. 


integer 
A compound document data type that represents a longword integer. 


item 
A specific unit of information stored in an aggregate. 


item change list 
A compound document data type that specifies a vector of longwords in which 
each longword contains the item code of an item in a segment attributes 
aggregate that has changed. 


kerning 
In typesetting, subtracting the space between two characters so that they 
appear closer together. 


language 
One of the languages specified by ISO 639. 


leaders 
In composition, rows of dashes or dots that are used to guide the eye across 
the page. Leaders are used in tabular work, programs, tables of contents, and 
so on. 


leading 
In composition, the distance between lines of type, measured in points. 


legend 
Like the legend of a map, the DDIF legend is used to describe the coordinate 
system of a segment. The legend information is used to indicate the scale of 
an illustration. See also Measurement. 


longword 
A compound document data type representing a 32 bit-encoded structure. 
The bits are interpreted according to a defined structure. 


marker 
An object used to mark a place. For example, markers can be used to mark 
data points on a graph. 


measurement 
DDIF measurements are specified using the units-per-measure segment 
attribute. By default, all measurements are in BMUs, 1/1200 of an inch. 
Scaling can be accomplished changing the units-per-measure for a document, 
or by using a transformation aggregate. 


measurement enumeration 


A compound document data type that is an enumeration specifying the data 
type of an item of DDIF type measurement, which is encoded as an integer or 
string. 
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object identifier 
A compound document data type that contains two or more longwords that 
specify the value of the DDIS type object identifier. Object identifiers are 
used to uniquely identify a class of object. 


octet 
An 8-bit byte. 


page 
A unit of display, such as a traditional sheet of paper, a video display, or a 
35mm slide. A page is a discrete unit of content presented for viewing. 


raster image content 
See image content. 


revisable document 
A document that contains abstract relationships between the components of 
the document. That is, the characteristics of the document that determine 
the final appearance are specified as parameters and directives that are used 
to create the final form. 


root aggregate 
An aggregate that represents the root of the in-memory document hierarchy. 


A root aggregate contains context private to the Toolkit routines. The type of 
a root aggregate is DDIF$_DDF. 


root segment 
A top-level segment that contains the document content. This document 
content can consist of content aggregates as well as nested segments. If 
a document contains only one segment, that segment is the root segment 
and contains all the document content. If the document contains multiple 
segments, they must be nested within a root segment. 


segment 


A quantity of content that is set off from surrounding data by a change in 
presentation or processing attributes. 


sequence 
A linked series of aggregates. 


sequence of 
A linked series of aggregates, all of which are the same type. 


single-precision floating-point 
A VAX F_floating-point value on VAX systems; an IEEE Standard 754 
single-precision floating-point value on non-VAX systems. The length of the 
buffer is always 4. Upon writing a floating-point value to a DDIS stream, 
the CDA Toolkit transforms the value to a generic DDIS floating-point value. 
When reading a single-precision floating-point value from a DDIS stream, the 
DDIS-encoded floating-point data is converted to the native (VAX or IEEE) 
format by the CDA Toolkit. 


soft content 


Content that is generated by software and is subject to recalculation when — 
the document is revised. 


specific attributes 
Attributes that are associated only with a single segment of content. These 
types of attributes are deliberately limited to a specific segment of the 
document. 


specific layout 
The layout of a particular document or document element. 


stream 
An access path by which encoded compound document data is read from or 
written to a storage medium. 


string 
A compound document data type that is encoded as a string of bytes. The 
length of the string is also specified in bytes. 


string with add-info 
A string whose character set is identified in an add-info parameter. 


style guide 
A relationship in a revisable document that defines a collection of generic 
types defined for use by a set of documents. For example, a style guide could 
be used to define a default newspaper layout or a standard letterhead. 


tag 
Tags are used to identify the type of a CDA item. For example, oD) is used 
to identify a segment’s content category as graphics. 


text content 
Content that consists of text in ASCII and alternate character sets. 


type reference 
A shorthand notation for the phrase “reference to generic type.” A type 
reference is a relationship in a revisable document that defines the situation 
of segments referencing the same generic type and therefore inheriting 
common attributes and processing and presentation styles. 


variable 


A compound document data type for which the data type of the item is 
determined by a preceding enumeration item. The enumeration item 
determines the data type of the variable item. 


variables 


A relationship in a revisable document that defines content that can be 
generated based on the values of variables, thereby ensuring that multiple 
elements of content are identical, have the same position, or can be modified 
by standard functions. 


Viewer 
The CDA Viewer is an application that can be used to look at a CDA (DDIF 
or DTIF) format document on a character-cell or a DECwindows display. 


widget 
A DECwindows object providing a user-interface abstraction, for example, a 
scroll bar or the CDA Viewer. 
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word 
A compound document data type that is encoded as a 16-bit structure. 


wrapping 
The process of breaking a stream of characters into lines that fit within the 
assigned galleys. 
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Absolute value construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Abs-value syntax diagram 
See ExpressionList syntax diagram 
Acos syntax diagram 
See ExpressionList syntax diagram 
Add-info 
See LOCATE ITEM routine; STORE ITEM routine 
Addition construct 
See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
Add syntax diagram 
See ExpressionList syntax diagram 
aggregate 
DTIF$_LPT_APPL_PRIVATE item in, 5—46 
Aggregate 
See also Root aggregate 
copying, 8—33 
creating, 8~36 
deleting, 8-58 
determining number of array elements in, 8-94 
inserting, 8-108 
locating an item in, 8-115 
locating next in sequence, 8-120 
reading from a front end, 8-24 
reading from a stream, 8-88 
removing from a document, 8-145 
removing from a sequence, 8-158 
writing the contents of, 8-150, 8-160 
Aggregates, DDIF, 1-5 
Aggregates, list of, 1-5 
AGGREGATE TYPE TO OBJECT ID routine, 8-3 
Allocate/Deallocate routines, 9-2 
Alog syntax diagram 
See ExpressionList syntax diagram 
Alternate presentation, 4—101 
Analysis back end, 2-8 
And syntax diagram 
See ExpressionList syntax diagram 
AngleRef enumeration, 1-1 
AngleRef syntax diagram, B-25 
Angle syntax diagram, B-25 
SAN tag, defined, 4-91 
Antilog construct 
See ExpressionList syntax diagram and CFE 
expressions, transcendental 
ANY built-in operator, defined, B-3 


Application images 
linking on ULTRIX, 8-2 
linking on VMS, 8-2 
Application private data 
See DTIF application private aggregate 
App!Private syntax diagram, B~-5, C—14, E-3 
Appreciation construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Apprec syntax diagram 
See ExpressionList syntax diagram 
Arc 
controlling the rendition of, 4-3 
specifying angle of rotation of, 4-4 
specifying center x-coordinate of, 4-3 
specifying center y-coordinate of, 4-3 
specifying delta y radius of, 4—4 
specifying the extent of, 4-4 
specifying the starting angle of, 4-4 
specifying x radius of, 4-3 
Arc content aggregate, 4-2 to 4-4 
See also DDIF$_ARC aggregate 
arc extent indicator item in, 4—4 
arc start indicator item in, 44 
center x indicator item in, 4-3 
center y indicator item in, 4-3 
delta y indicator item, 4-4 
flags item in, 4-3 
items in, 4—2t 
rotation indicator item in, 4—4 
x radius item in, 4-3 
Arc cosine construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
ArcPath syntax diagram, B-30 
Arc sine construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Arc syntax diagram, B-12 
Arc tangent 2 construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Arc tangent construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Arithmetic shift left construct 
See ExpressionList syntax diagram and CFE 
expressions, binary 
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Arithmetic shift right construct 


See ExpressionList syntax diagram and CFE 
expressions, binary 
Array definition aggregate, 5-2 to 5-3 
array values item in, 5-3 
descriptor item in, 5~—2 
element type size indicator item in, 5-2 
items in, 5-2 
value item in, 5-3 
x dimension item in, 5-3 
y dimension item in, 5-3 
z dimension item in, 5-3 
ArrayDefn syntax diagram, C-8 
Arrays 
See Array values 
Array values 
specifying array element type size indicator for, 
specifying descriptor item for, 5-2 
specifying nonstandard data types for, 5-3 
specifying standard data types for, 5—2 
specifying the x dimension for, 5-3 
specifying the y dimension for, 5-3 
specifying the z dimension for, 5-3 
specifying value item for, 5-3 
$ASCIl collating sequence, 5-49 
ASCIIString syntax diagram, B-25, C—15 
Asin syntax diagram 
See ExpressionList syntax diagram 
Asl syntax diagram 
See ExpressionList syntax diagram 
Asr syntax diagram 
See ExpressionList syntax diagram 
Assignment built-in operator, defined, B-3 
Atan2 syntax diagram 
See ExpressionList syntax diagram 
Atan syntax diagram 
See ExpressionList syntax diagram 
Attribute 
specifying for a galley, 4-133 
specifying for a line, 4-128 to 4~—131 
specifying for a marker, 4-132 
specifying for an image, 4-134 to 4-136 
specifying for image component space, 4-137 to 
4-138 
specifying for text, 4-118 to 4-127 
Average construct 
See ExpressionList syntax diagram and CFE 
expressions, statistical 
Avg syntax diagram 
See ExpressionList syntax diagram 


Back end 
analysis, 2-8 
DDIF, 2-3 
ddif$write_format entry point, 11-16 
domain$write_format entry point, 11-15 
dtif$write_format entry point, 11-16 
entry point, 8-16 
PostScript, 2-5 to 2-8 
text, 2-4 to 2-5 


Iindex—2 


Background 

See Pattern definition; Pattern definition aggregate; 

Image component space 

BeginSegment syntax diagram, B-7 
Between construct 

See ExpressionList syntax diagram and CFE 

expressions, Boolean and relational 

Bezier curve 

controlling rendition of, 4—5 

specifying layout of, 4-6 
Bezier curve aggregate, 4-5 to 4-6 

See also DDIF$_BEZ aggregate 

curve path indicator item in, 4-6 

flags item in, 4-5 

items in, 4—5t 
Binding syntax diagram, B-36 
BIT STRING buiit-in primitive, defined, B-1 
BMU (Basic Measurement Unit) 

definition of, 4-100 
BOOLEAN built-in primitive, defined, B—1 
BoundingBox syntax diagram, B-18 
BreakCriteria syntax diagram, B-42 


C 


Callable interface 

CDA viewer routines, 13-1 
CategoryTag syntax diagram, B-35 
cda$aggregate_type_to_object_id, 8-3 
cda$close_file, 8-6 
cda$close_stream, 8-9 
cda$close_text_file, 8-11 
cda$convert, 8-13 
cda$convert_aggregate, 8-24 
cda$convert_document, 8-28 
cda$convert_position, 8-31 
cda$copy_aggregate, 8-33 
cda$create_aggregate, 8-36 
cda$create_file, 8-39 
cda$create_root_aggregate, 8-45 
cda$create_stream, 8-50 
cda$create_text_file, 8-54 
cda$delete_aggregate, 8-58 
cda$delete_root_aggregate, 8-60 
cda$enter_scope, 8-62 
cda$erase_item, 8-76 
cda$find_definition, 8-79 
cda$find_transformation, 8-83 
cda$flush_stream, 8-86 
cda$get_aggregate, 8-88 
cda$get_array_size, 8-94 
cda$get_document, 8-97 
cda$get_external_encoding, 8-100 
cda$get_stream_position, 8-103 
cda$get_text_position, 8-106 
cda$insert_aggregate, 8-108 
cda$leave_scope, 8-112 
cda$locate_item, 8-115 
cda$next_aggregate, 8-120 
cda$object_id_to_aggregate_type, 8-123 
cda$open_converter, 8-126 
cda$open_file, 8-130 
cda$open_stream, 8-138 
cda$open_text_file, 8-141 
cda$prune_aggregate, 8-145 
cda$prune_position, 8-148 


cda$put_aggregate, 8-150 
cda$put_document, 8-153 
cda$read_text_file, 8-156 
cda$remove_aggregate, 8-158 
cda$store_item, 8—160 
cda$write_text_file, 8-168 
CDA$_ facility messages, G-1 to G-6 
CdaAggregateTypeToObjectid, 8-3 
CdaCloseFile, 8-6 
CdaCloseStream, 8-9 
CdaCloseTextFile, 8—11 
CdaConvert, 8—13 
CdaConvertAggregate, 8-24 
CdaConvertDocument, 8-28 
CdaConvertPosition, 8-31 
CdaCopyAggregate, 8-33 
CdaCreateAggregate, 8-36 
CdaCreateFile, 8-39 
CdaCreateRootAggregate, 8-45 
CdaCreateStream, 8-50 
CdaCreateTextFile, 8-54 
CDA default values, 1-4 
CdaDeleteAggregate, 8-58 
CdaDeleteRootAggregate, 8-60 
CdaEnterScope, 8-62 
CdaEraseltem, 8-76 
CdaFindDefinition, 8-79 
CdaFindTransformation, 8-83 
CdaFlushStream, 8-86 
CdaGetAggregate, 8-88 
CdaGetArraySize, 8-94 
CdaGetDocument, 8-97 
CdaGetExternalEncoding, 8-100 
CdaGetStreamPosition, 8-103 
CdaGetTextPosition, 8-106 
CdalnsertAggregate, 8-108 
CDA item data types, 1-1t 
CdaLeaveScope, 8-112 
CdaLocateltem, 8-115 
CdaNextAggregate, 8-120 
CdaObjectldToAggregateType, 8-123 
CdaOpenConverter, 8-126 
CdaOpenFile, 8-130 
CdaOpenStream, 8-138 
CdaOpentextFile, 8-141 
CdaPruneAggregate, 8-145 
CdaPrunePosition, 8-148 
CdaPutAggregate, 8-150 
CdaPutDocument, 8-153 
CdaReadTextFile, 8-156 
CdaRemoveAggregate, 8-158 
CdaStoreltem, 8-160 
CDA viewer 

callable interface, 13—1 
CdaWriteTextFile, 8-168 
cdoc command, 2-16 to 2-17 

-d format qualifier, 2-16 

-O options qualifier, 2-17 

-S format qualifier, 2-16 
Cell-col syntax diagram 


See ExpressionList syntax diagram 
Cell coordinate construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Cell coordinates aggregate 


See CFE cell coordinates aggregate _ 


Cell coordinates aggregate (Cont.) 


See DTIF cell coordinates aggregate 
Cell-coord syntax diagram 
See ExpressionList syntax diagram 
CellCoord syntax diagram, C—16 
Cell data 
empty cells in, 5-13 
missing values in, 5-13 
null cells in, 5-13 
sparse encoding of, 5-13 
specifying a cell state in, 5-14 
- specifying a column number in, 5-14 
specifying a descriptor item for, 5-15 
specifying a value data indicator for, 5-15 
specifying expressions for, 5-16 
specifying formats for, 5-15 
specifying private data for, 5-15 
Cell data aggregate, 5-13 to 5~17 
cell descriptor item in, 5-15 
cell state item in, 5-14 
column number item in, 5—14 
expression item in, 5-16 
format item in, 5-15 
items in, 5-14 
private cell data item in, 5-15 
value data indicator item in, 5-15 
value item in, 5-16 
CellData syntax diagram, C-6 
Cell extract construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Cell-extract syntax diagram 
See ExpressionList syntax diagram 
Cell indirection construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Cell-indirect syntax diagram 
See ExpressionList syntax diagram 
Cell-name syntax diagram 
See ExpressionList syntax diagram 
Cell range aggregate 
See CFE cell range aggregate 


See DTIF ‘cell range aggregate 
Cell range construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Cell-range syntax diagram 
See ExpressionList syntax diagram 
CellRange syntax diagram, C-—18 
Cell-row syntax diagram 
See ExpressionList syntax diagram 
Cells 
See Cell data 
Cell states 
to determine valid cell values, 5-15 
CellValue syntax diagram, C-7 
CFE$_AGGREGATE_TYPE aggregate item, 6-1 
CFE$_CCD aggregate, 6-2 to 6-3 
CFE$_CCD_COLUMN item in, 6-2 
CFE$.-CCD_FLAGS item in, 6-2 
CFE$_CCD_ROW item in, 6-2 
items in, 6-2 
CFE$_CFT aggregate, 6-4 
CFE$_CFT_REAL_PART item in, 6—4 
items in, 6-4 
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CFE$_CLR aggregate, 6-5 
CFE$_CLR_RANGE_BEGIN item in, 6-5 
CFE$_CLR_RANGE_END item in, 6-5 
items in, 6-5 

CFE$_COR aggregate, 6-6 
CFE$_COR_COL_BEGIN item in, 6-6 
CFE$_COR_COL_END item in, 6-6 
items in, 6-6 

CFE$_DAT aggregate, 6-7 to 6-8 
CFE$_DAT_DATETIME item in, 6-7 
CFE$_DAT_TIME_DIFF item in, 6-8 
CFE$_DAT_TIME_DIFF_C item in, 6-7 
items in, 6-7 

CFE$_EXL aggregate, 6-9 to 6-52 
CFE$_EXL_EXPR item in, 6-52 
items in, 6-9 

CFE$_EXP aggregate, 6-53 to 6-54 
CFE$_EXP_LIST item in, 6-53 
CFE$_EXP_MAJOR_VERSION item in, 6-53 
CFE$_EXP_MINOR_VERSION item in, 6-53 
items in, 6-53 

CFE$_FLT aggregate 
CFE$_CFT_IMAGINARY_PART item in, 6-4 

CFE$_FRF aggregate, 6-55 
CFE$_FRF_FIELD_CONTEXT item in, 6-55 
CFE$_FRF_PATH item in, 6-55 
items in, 6-55 

CFE$_NPM aggregate, 6-56 
CFE$_NPM_NAME item in, 6-56 
CFE$_NPM_VALUE item in, 6-56 
items in, 6-56 

CFE$_PEX 
CFE$_PEX_END_EXPR item in, 6-57 

CFE$_PEX aggregate, 6-57 
CFE$_PEX_BEGIN_EXPR item in, 6-57 
CFE$_PEX_VALUE_EXPR item in, 6-57 
CFE$_PFE_FACILITY item in, 6-58 
CFE$_PFE_NAME item in, 6-58 
items in, 6-57 

CFE$_PFE aggregate, 6-58 to 6-59 
CFE$_PFE_PARAMS item in, 6-59 
CFE$_PFE_REF_LABEL item in, 6-58 
CFE$_PFE_REF_LABEL TYPE item in, 6-58 
CFE$_PFE_RETURN_TYPE item in, 6~59 
items in, 6-58 

CFE$_RWR aggregate, 6-60 
CFE$_RWR_ROW_BEGIN item in, 6-60 
CFE$_RWR_ROW_END item in, 6-60 
items in, 6-60 

CFE$_SLL aggregate, 6-61 
CFE$_SLL_CRITERIA item in, 6-61 
CFE$_SLL_SELECTION item in, 6-61 
items in, 6-61 

CFE$_STF aggregate, 6-62 
CFE$_STF_EDIT_STRING item in, 6-62 
CFE$_STF_SOURCE item in, 6-62 
items in, 6-62 

CFE$_STP aggregate, 6-63 
CFE$_STP_PRETTY_FLAGS item in, 6-63 
CFE$_STP_STRING_EXPR item in, 6-63 
items in, 6-63 \ 

CFE$_TXC aggregate, 6-64 
CFE$_TXC_TEXT_C item in, 6-64 
items in, 6-64 

CFE$_USER_CONTEXT aggregate item, 6-1 

CFE$_VTX aggregate, 6-65 
CFE$_VTX_VTEXT_LEN item in, 6-65 
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CFE$_VTX aggregate (Cont.) 
CFE$_VTX_VTEXT_STR item in, 6-65 
items in, 6-65 
CFE application private aggregate, 6-58 to 6-59 
facility name item in, 6-58 
function name item in, 6-58 
items in, 6-58 
parameters item in, 6-59 
reference label item in, 6-58 
reference storage item in, 6-58 
return type item in, 6-59 
CFE cell coordinates 
absolute references, 6-2 
relative references, 6-2 
CFE cell coordinates aggregate, 6-2 to 6— 
column identifier item in, 6-2 
flags item in, 6-2 
items in, 6-2 
row identifier item in, 6-2 
CFE cell range aggregate, 6-5 
items in, 6-5 
range begin item in, 6-5 
range end item in, 6-5 
CFE column range aggregate, 6-6 
column begin item in, 6-6 
column end item in, 6-6 
items in, 6-6 
CFE complex float aggregate, 6-4 
imaginary portion value item in, 6—4 
items in, 6-4 
real portion value item in, 6-4 
CFE date and time aggregate, 6-7 to 6-8 
date and time item in, 6-7 
items in, 6-7 
time difference item in, 6-7 
CFE document 
specifying date and time values for, 6-7 
CFE expressions 
arithmetic 
addition, 6-10 
division, 6-10 
multiplication, 6-10 
negation, 6-10 
percent, 6-10 
raise to a power, 6—10 
subtraction, 6—11 
unary plus, 6-11 

binary 
arithmetic shift left, 6-11 
arithmetic shift right, 6-11 
one’s complement, 6-11 

Boolean and relational 
absolute value, 6-12 
between, 6-12 
conditional (if-then-else), 6-13 
equal to, 6-12 
greater than, 6—12 
greater than or equal to, 6-12 
less than, 6-13 
less than or equal to, 6-13 
logical AND, 6-12 
logical NOT, 6-13 
logical OR, 6-14 
modulus, 6-13 
not equal to, 6-13 
square root, 6-14 


CFE expressions (Cont.) 

celil-related 

cell extract, 6-14 

cell indirection, 6-15 

column portion of cell name, 6-14 

constructed cell reference, 6-15 

count columns, 6-15 

count rows, 6-16 

current cell, 6-16 

current column, 6-16 

current row, 6-16 

error, 6-16 

not available, 6-16 

not calculable, 6—16 

null, 6-16 

row portion of cell name, 6-15 
choose and lookup 

choose, 6-17 

field in table, 6-18 

hlookup, 6-17 

index, 6~17 

matches, 6-18 

table, 6-18 

vlookup, 6-19 
contants 

true, 6-42 
conversion 

convert to value, 6-19 

decimal string, 6-19 

integer, 6-19 

round to the nearest whole number, 6-20 

truncate, 6-20 
convert string to date, 6-21 
convert string to time, 6-21 
date. difference 

day, 6-21 

hour, 6—21 

minute, 6-21 

month, 6-22 

second, 6-22 

week, 6-22 

year, 6-22 
date/time 

date day of the week, 6-23 

date month name, 6-24 

day of the week, 6-24 

month name, 6-25 
date/time addition 

days, 6-25 

hours, 6-25 

minutes, 6-25 

months, 6-25 

seconds, 6-26 

weeks, 6-26 

years, 6-26 
date/time extraction 

day, 6-22 

hour, 6-22 

minute, 6-23 

month, 6-23 

second, 6-23 

year, 6-23 
date/time literals 

now, 6-25 

today, 6-26 

tomorrow, 6-26 

yesterday, 6-26 


CFE expressions (Cont.) 


field reference, 6—42 
financial 


appreciation, 6-27 

depreciation—declining balance, 6-29 

depreciation—declining balance with crossover 
to straight line, 6-28 

depreciation—straight line, 6-30 

depreciation—sum of year’s digits, 6-30 

discount, 6-31 

financial 
depreciation—double declining balance, 

6-29 

future value, 6-31 

future value of an annuity, 6-32 

future value of a single sum, 6-32 

interest payments, 6-33 

interest rate, 6-39 

internal rate of return, 6-34 

modified internal rate of return, 6-34 

net present value, 6-35 

number of periods given present value, 6-36 

number of periods to achieve future value, 
6-36 

payback, 6-35 

payment per period given present value, 6-37 

payment per period to achieve future value, 
6-37 

periods to achieve future value, 6~35 

present value of an annuity, 6-38 

present value to achieve future value, 6—39 

principal, 6-38 


identification 


isblank, 6-39 

isdate, 6-39 

iserror, 6-40 

is not available, 6-40 
is not calculable, 6-40 
isnull, 6-40 
isnumber, 6—40 

isref, 6-40 

isstring, 6-41 


literals 


complex floating-point, 6-41 
date, 6-41 

floating-point, 6-41 

integer, 6-41 

scaled integer, 6-42 

text string, 6-42 

varying length text, 6-42 


miscellaneous 


parenthesized, 6-42 


private, 6-43 
random number, 6-43 
series 


integrate, 6—43 
least squares, 6-43 
logest, 6-43 
sigma, 6-43 

trend, 6-44 


sign, 6-43 

specifying for a cell, 5-16 
specifying for a column, 5-5 
statistical 


average, 6-44 
count, 6-44. 
maximum, 6—44 


Index—5 


CFE expressions 
Statistical (Cont.) 
minimum, 6—45 
standard deviation, 6—45 
summation, 6-45 
variance, 6-46 
string 
contains substring, 6-47 
extract substring left, 6-48 
extract substring right, 6-49 
string character, 6-46 
string character code, 6-46 
string concatenate, 6-46 
string extract, 6-47 
string find substring, 6-47 
string fixed, 6-47 
string format, 6-48 
string length, 6-48 
string lowercase, 6-48 
string pretty, 6-48 
string proper, 6-48 
string repeat, 6-48 
string replace, 6-49 
string reverse, 6-49 
string starts with, 6-47 
string trim, 6-49 
string uppercase, 6-49 
transcendental 
antilog, 6-49 
exponent, 6-50 
factorial, 6-50 
log, base 10, 6-50 
log, base e (natural), 6-50 
trigonometric 
arc cosine, 6-50 
arc sine, 6-50 
arc tangent, 6-50 
arc tangent 2, 6-51 
cosine, 6-51 
sine, 6-51 
tangent, 6-51 
variables 
cell coordinate, 6-51 
cell range, 6-51 
column name, 6-51 
column number, 6-51 
column range, 6-52 
current value, 6-52 
false, 6-41 
identifier, 6—52 
named range, 6-52 
Pl, 6-41 
row number, 6-52 
row range, 6-52 
CFE generic aggregate items, 6—1 
CFE$_AGGREGATE_TYPE, 6-1 
CFE$_USER_CONTEXT, 6-1 
CFE row range aggregate, 6-60 
items in, 6-60 
row begin daia item in, 6-60 
row end data item in, 6—60 
CFE syntax diagrams, D-1 to D-9 
CFE varying text aggregate, 6-65 
character string data item in, 6-65 
items in, 6-65 
varying text length item in, 6-65 
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Character set 

identifiers for, 4—32t 
Character string, defined, 1-2 
Character-String defined type, defined, B-4 
Character-String syntax diagram, B-5 
CHOICE built-in operator, defined, B-3 
Choose construct 

See ExpressionList syntax diagram and CFE 

expressions, choose and lookup 

Circle 

See Arc 
Close entry point, 11-3 
CLOSE FILE routine, 8-6 
CLOSE STREAM routine, 8-9 
CLOSE TEXT FILE routine, 8-11 
ColAttributes syntax diagram, C-9 
Collating sequences 

ASCII, 5-49 

Danish, 5-49 

Finnish, 5-49 

Multinational Character Set, 5-49 

Norwegian, 5-49 

private, 5-49 

Spanish, 5-49 
Col-name syntax diagram 

See ExpressionList syntax diagram 
Col-num syntax diagram 

See ExpressionList syntax diagram 
ColNum syntax diagram, C-16 
Color 

See also Image component space 


See Pattern definition 
Color syntax diagram, B-19 
Col-range syntax diagram 
See ExpressionList syntax diagram 
ColRange syntax diagram, C-18 
Column attributes 
specifying a column header name for, 5-8 
specifying a column query name for, 5-7 
specifying a descriptor for, 5-5 
specifying a generic attribute reference in, 5-5 
specifying an identifier for, 5-4 
specifying a value for, 5-5 
specifying default values for, 5-5 
specifying expressions for, 5-5 
specifying flags for, 5-8 
specifying formats for, 5-5 
specifying numeric or character string indicator for, 
5-6 
specifying private data for, 5-5 
specifying the data length of, 5-8 
specifying the data type of, 5-8 
specifying the scale factor of, 5-8 
specifying within table metadata, 5-63 
Column attributes aggregate, 5—4 to 5-9 
column descriptor item in, 5—5 
column header name item in, 5-8 
column query name item in, 5—7 
data length item in, 5-8 
data type item in, 5-8 
default values indicator item in, 5-5 
default values item in, 5-6 
expression item in, 5-5 
flags item in, 5-8 
format item in, 5-5 
generic attribute reference item in, 5-5 


Column attributes aggregate (Cont.) 
identifier item in, 5-4 
items in, 5-4 
numeric or missing character string item in, 5—7 
private column attribute data item in, 5-5 
scale factor item in, 5-8 
value item in, 5-5 
Column name construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Column number construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Column portion of cell name construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Column range aggregate 
See CFE column range aggregate 


See DTIF column range aggregate 
Column range construct 


See ExpressionList syntax diagram and CFE 
expressions, variables 
Columns 
See Column attributes 
Comment built-in operator, defined, B-3 
Complex float aggregate 
See CFE complex float aggregate 
See DTIF complex float aggregate 
Complex floating-point construct 


See ExpressionList syntax diagram and CFE 
expressions, literals 
Complex floating-point values 
specifying the imaginary portion for, 5-12, 6-4 
specifying the real portion for, 5-12, 6-4 
ComplexFloat syntax diagram, C—8 
Composite path 
arc component of, 4—71 
Bézier component of, 4—71 
indicating angle of rotation of, 4-73 
indicating center x-coordinate of an arc in, 4-72 
indicating center y-coordinate of an arc in, 4-72 
indicating delta y radius of an arc in, 4-72 
indicating extent of an arc in, 4-73 
indicating type of path defined in, 4—71 
indicating x radius of an arc in, 4-72 
polyline component of, 4-71 
referencing a component of, 4—71, 4-73 
specifying layout of the curve in, 4-72 
specifying polyline path in, 4-71 
specifying starting angle of an arc in, 4-73 
Composite path aggregate, 4-70 to 4-73 
See also DDIF$_PTH aggregate 
arc center x indicator item in, 4-72 
arc center y indicator item in, 4-72 
arc extent indicator item in, 4-73 
arc radius delta y indicator item in, 4-72 
arc radius x indicator item in, 4-72 
arc rotation indicator item in, 4-73 
arc start indicator item in, 4-73 
curve path indicator item in, 4-72 
items in, 4—70t 
line path indicator item in, 4-71 
path indicator item in, 4-71 
path reference item in, 4-73 
CompositePath syntax diagram, B-30 


Compound document 
validating contents of, 8-130 
Computed content 
copied, 4-93 
cross-reference, 4—95 
function, 4-96 
indicating function parameters for, 4-96 
specifying an index into a list of references for, 
4-93 
specifying attributes for, 4-92 to 4-96 
specifying function name in, 4-96 
specifying label of a segment being referenced by, 
4-93 
specifying label of the target segment, 4-95 
specifying name of the variable in, 4-94 
specifying reference index for, 4-95 
specifying the name of the referenced variable in, 
4-95 
variable, 4-94 
Computed content external, 1-16 
ComputeDefn syntax diagram, B-19 
ConformanceTag syntax diagram, B-35 
Constructed cell reference construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Contains substring construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
Contains syntax diagram 
See ExpressionList syntax diagram 
Content 
computed 
specifying attributes for, 4~92 to 4-96 
indicating relational position of a segment of, 4-111 
presentation styles for, 4-78 
restricted 
external, 4-21 to 4~—22 
specifying alternate presentation string for, 4-101 
specifying character horizontal alignment point for, 
4-107 
specifying character vertical alignment point for, 
4—108 
specifying general character set for, 4-32 
specifying general layout attributes for, 4-104 
specifying Latin1 character set for, 4-164 
specifying magnitude of coordinate system. ratio for, 
4-99 
specifying name of the measurement system of, 
4-100 
specifying number of units per inch of, 4-100 
specifying precision in coordinate system ratio for, 
4-99 
specifying string format of, 4-106 
specifying the character orientation in, 4—106 
specifying the layout of, 4-103 
specifying the name of the coordinate system of, 
4-99 
specifying the string imaging path of, 4-105 
specifying world coordinate system for, 4-99 
specifying wrap attributes for, 4-104 
text 
general, 4-32 
Latin1, 4-164 
Content aggregates, defined, 1—5 
Content definition 
specifying elements in, 4-9 
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Content definition (Cont.) 

specifying index into list of external references in, 

4-9 

specifying label of, 4-8 

specifying label of the referenced segment in, 4-8 

specifying private data for, 4-9 
Content definition aggregate, 4-8 to 4-9 

See also DDIF$_CTD aggregate 

external reference index item in, 4-9 

external target item in, 4-8 

items in, 4—8t 

label item in, 4-8 

private data item in, 4-9 

value item in, 4-9 
Content definitions, 1-16 
ContentDefnLabel syntax diagram, B-24 
ContentDefn syntax diagram, B-24 
ContentPrimitive syntax diagram, B-6 
Content reference 

specifying label for, 4—7 

specifying transformation for, 4~—7 
Content reference aggregate, 4—7 

See also DDIF$_CRF aggregate 

items in, 4—7t 

label item in, 4~7 

transformation item in, 4-7 
ContentReferencePrimitive syntax diagram, B-18 
Content references, 1-15, 1-16 
ContentReference syntax diagram, B-18 
Content syntax diagram, B-6 
Content tags 


See DDIF tags 
Contiguous ranges, 5-55 
See also Ranges 
Conversion 
input formats, 2-1 to 2-3 
output formats, 2-3 to 2-9 
Conversion restrictions 
DTIF back end, 2-4 
DTIF front end, 2-2 
in DDIF back end, 2-3 
in DDIF front end, 2-1 
in PostScript back end, 2-5 
in Text back end, 2—4 
in Text front end, 2-3 
CONVERT AGGREGATE routine, 8-24 
CONVERT/DOCUMENT command, 2-11 to 2-12 
/OPTIONS qualifier, 2-11 
CONVERT DOCUMENT routine, 8-28 
Converter . 
activating, 8-126 
calling from an application, 8-13 
Converters 
linking on ULTRIX, 11-2 
linking on VMS, 11-2 
CONVERT POSITION routine, 8-31 
CONVERT routine, 8-13 
Convert string to date construct 
See ExpressionList syntax diagram and CFE 
expressions, convert string to date 
Convert siring to time construct 
See ExpressionList syntax diagram and CFE 
expressions, convert string to time 
Convert to value construct 
See ExpressionList syntax diagram and CFE 
expressions, conversion 
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Copied computed content, 4-93 
COPY AGGREGATE routine, 8-33 
Copying CDA documents 
on an ULTRIX system, 3-3 
ona VMS system, 3-3 
Cosine construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Cos syntax diagram 
See ExpressionList syntax diagram 
Count-cols syntax diagram 
See ExpressionList syntax diagram 
Count columns construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Count construct 
See ExpressionList syntax diagram and CFE 
expressions, statistical 
Counter 
specifying style for, 4—11 
CounterDefn syntax diagram, B-37 
Counter style aggregate, 4-10 to 4-11 
See also DDIF$_CTS aggregate 
items in, 4—10t 
style indicator item in, 4-11 
CounterStyle syntax diagram, B-38 
Count rows construct » 
See ExpressionList syntax diagram and CFE 
exprssions, cell-related 
Count-rows syntax diagram 


See ExpressionList syntax diagram 
CREATE AGGREGATE routine, 8-36 
CREATE FILE routine, 8-39 
CREATE ROOT AGGREGATE routine, 8-45 
CREATE STREAM routine, 8-50 
CREATE TEXT FILE routine, 8-54 
$CRF tag, defined, 4~—91 
Cross-reference computed content, 4-95 
CrossRef syntax diagram, B-20 
CubicBezier 
See also Bezier curve 
CubicBezierPath syntax diagram, B-31 
CubicBezier syntax diagram, B—12 
Cur-cell syntax diagram 
See ExpressionList syntax diagram 
Cur-col syntax diagram 
See ExpressionList syntax diagram 
Current cell construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Current column construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Current row construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Current value construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Current-value syntax diagram 
See ExpressionList syntax diagram 
Cur-row syntax diagram 
See ExpressionList syntax diagram 
Curve 
See Bezier curve 


Cvt-to-date syntax diagram 

See ExpressionList syntax diagram 
Cvt-to-time syntax diagram 

See ExpressionList syntax diagram 
Cvt-to-value syntax diagram 

See ExpressionList syntax diagram 


D 


$DANISH collating sequence, 5-49 
Data 
private, 4-74 
Data mapping 
DTIF back end, 2-3 
DTIF front end, 2-2 
in DDIF back end, 2-3 
in DDIF front end, 2—1 
in PostScript back end, 2-5 
in Text back end, 2—4 
in Text front end, 2-2 
Datatype syntax diagram, C—10 
Date construct 
See ExpressionList syntax diagram and CFE 
expressions, literals 
Date day of the week construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time 
$DATE editstring-name, 5-49 
DateFmt syniax diagram, C-13 
Date month name consiruct 
See ExpressionList syntax diagram and CFE 
expressions, date/time 
Date/time addition constructs 
See ExpressionList syntax diagram and CFE 
expressions, date/time addition 
Date/time difference constructs 
See ExpressionList syntax diagram and CFE 
expressions, date difference 
$DATETIME editstring-name, 5-49 
Date/time extraction constructs 
See ExpressionList syntax diagram and CFE 
expressions, date/time extraction 
DateTime syntax diagram, C-14 
Day of the week construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time 
$DB tag, defined, 4~30, 4-90 
DDDIF$_FTD aggregate 
DIF$_FTD_NUMBER item in, 4-25 
DDIF$SREAD_format, 8-15 
ddif$write_format, 8—16 
DDIF$_AGGREGATE_TYPE aggregate item, defined, 
4-1 
DDIF$_ARC aggregate, 4-2 to 4-4 
DDIF$_ARC_CENTER_X item in, 4-3 
DDIF$_ARC_CENTER_X_C item in, 4-3 
DDIF$_ARC_CENTER_Y item in, 4-3 
DDIF$_ARC_CENTER_Y_C item in, 4-3 
DDIF$_ARC_EXTENT item in, 4-4 
DDIF$_ARC_EXTENT_C item in, 4-4 
DDIF$_ARC_FLAGS item in, 4-3 
DDIF$_ARC_RADIUS_DELTA_Y item in, 4-4 
DDIF$_ARC_RADIUS_DELTA_Y_C item in, 4-4 
DDIF$_ARC_RADIUS_X item in, 4-3 
DDIF$_ARC_RADIUS_X_C item in, 4-3 
DDIF$_ARC_ROTATION item in, 4-4 


DDIF$_ARC aggregate (Cont.) 
DDIF$_ARC_ROTATION_C item in, 4-4 
DDIF$_ARC_START item in, 4-4 
DDIF$_ARC_START_C item in, 4—4 
items in, 4-2t 

DDIF$_BEZ aggregate, 4-5 to 4-6 
DDIF$_BEZ_ FLAGS item in, 4-5 
DDIF$_BEZ_PATH item in, 4-6 
DDIF$_BEZ_PATH_C item in, 4-6 
items in, 4—5t 

DDIF$_CRF aggregate, 4-7 
DDIF$_CRF_REFERENCE item in, 4-7 
DDIF$_CRF_TRANSFORNM item in, 4—7 
items in, 4-7t 

DDIF$_CTD aggregate, 4-8 to 4-9 
DDIF$_CTD_EXTERNAL_ERF_INDExX item in, 

4-9 
DDIF$_CTD_EXTERNAL_TARGET item in, 4-8 
DDIF$_CTD_LABEL item in, 4-8 
DDIF$_CTD_PRIVATE_DATA item in, 4-9 
DDIF$_CTD_VALUE item in, 4-9 
items in, 4—8t 

DDIF$_CTS aggregate, 4-10 to 4-11 
DDIF$_CTS_STYLE item in, 4-11 
DDIF$_CTS_STYLE_C item in, 4-11 
items in, 4—10t 

DDIF$_DDF aggregate, 4-12 
DDIF$_DDF_CONTENT item in, 4-12 
DDIF$_DDF_DESCRIPTOR item in, 4-12 
DDIF$_DDF_HEADER item in, 4-12 

DDIF$_DDIF$_SGB aggregate 
DDIF$_SGB_CTR_TRIGGER item in, 4-156 

DDIF$_DHD aggregate, 4-13 
DDIF$_DHD_AUTHOR item in, 4—14 
DDIF$_DHD_CONFORMANCE_TAGS item in, 

4-14 
DDIF$_DHD_DATE item in, 4-14 
DDIF$_DHD_EXTERNAL_REFERENCES item in, 
4-14 
DDIF$_DHD_LANGUAGES item in, 4-15 
DDIF$_DHD_LANGUAGES C item in, 4-14 
DDIF$_DHD_PRIVATE_DATA item in, 4-13 
DDIF$_DHD_STYLE_GUIDE item in, 4-15 
DDIF$_DHD_TITLE item in, 4-13 
DDIF$_DHD_VERSION item in, 4-14 

DDIF$_DSC aggregate, 4-16 to 4-17 
DDIF$_DSC_MAJOR_VERSION item in, 4-16 
DDIF$_DSC_MINOR_VERSION item in, 4-16 
DDIF$_DSC_PRODUCT_IDENTIFIER item in, 

4-17 
DDIF$_DSC_PRODUCT_NAME item in, 4-17 

DDIF$_ERF aggregate, 4-18 to 4-20 
DDIF$_ERF_CONTROL item in, 4—20 
DDIF$_ERF_DATA_TYPE item in, 4-18 
DDIF$_ERF_DESCRIPTOR item in, 4-18 
DDIF$_ERF_LABEL item in, 4-18 
DDIF$_ERF_LABEL_TYPE item in, 4-18 
items in, 4—18t 

DDIF$_EXT aggregate, 4-21 to 4-22 
DDIF$_EXT_DATA_VALUE_DESCRIPTOR item in, 

4-21 
DDIF$_EXT_DIRECT_REFERENCE item in, 4-21 
DDIF$_EXT_ENCODING item in, 4-22 
DDIF$_EXT_ENCODING_C item in, 4-22 
DDIF$_EXT_ENCODING_L item in, 4-22 
DDIF$_EXT_INDIRECT_REFERENCE item in, 
4-21 
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DDIF$_EXT aggregate (Cont.) 
items in, 4-21t 

DDIF$_FAS aggregate, 4-23 to 4-24 
DDIF$_FAS_FLAGS item in, 4-23 
DDIF$_FAS_PATH item in, 4-24 
items in, 4-23t 

DDIF$_FTD aggregate, 4—25 
DDIF$_FTD_IDENTIFIER item in, 4-25 
DDIF$_FTD_PRIVATE_DATA item in, 4-25 
items in, 4—25t 

DDIF$_GLA aggregate, 4-26 to 4-27 
DDIF$_GLA_BOTTOM_MARGIN item in, 4-27 
DDIF$_GLA_BOTTOM_MARGIN_C item in, 4-27 
DDIF$_GLA_LEFT_MARGIN item in, 4-27 
DDIF$_GLA_LEFT_MARGIN_C item in, 4-26 
DDIF$_GLA_RIGHT_MARGIN item in, 4-27 
DDIF$_GLA_RIGHT_MARGIN_C item in, 4-27 
DDIF$_GLA_TOP_MARGIN item in, 4-26 
DDIF$_GLA_TOP_MARGIN_C item in, 4-26 
items in, 4—26t 

DDIF$_GLY aggregate, 4-28 to 4-31 
DDIF$_GLY_BOUNDING_BOX_LL_X item in, 


4-29 
DDIF$_GLY_BOUNDING_BOX_LL_X_C item in, 
4-29 
DDIF$_GLY_BOUNDING_BOX_LL_Y item in, 
4-29 
DDIF$_GLY_BOUNDING_BOX_LL_Y_C item in, 
4-29 
DDIF$_GLY_BOUNDING_BOX_UR_X item in, 
. 4-29 
DDIF$_GLY_BOUNDING_BOX_UR_X_C item in, 
4-29 
DDIF$_GLY_BOUNDING_BOX_UR_Y item in, 
4-30 
DDIF$_GLY_BOUNDING_BOX_UR_Y_C item in, 
4-29 


DDIF$_GLY_FLAGS item in, 4-30 
DDIF$_GLY_ID item in, 4-29 
DDIF$_GLY_OUTLINE item in, 4-30 
DDIF$_GLY_STREAMS item in, 4-30 
DDIF$_GLY_SUCCESSOR item in, 4-31 
DDIF$_GLY_SUCCESSOR_C item in, 4-31 
items in, 4—28t 
DDIF$_GTX aggregate, 4-32 
DDIF$_GTX_CONTENT item in, 4-32 
DDIF$_HRD aggregate, 4-34 
DDIF$_HRD_DIRECTIVE item in, 4-35 
DDIF$_HRV aggregate, 4-36 to 4-37 
DDIF$_HRV_C item in, 4-37 
DDIF$_HRV_ESC_CONSTANT item in, 4-37 
DDIF$_HRV_ESC_CONSTANT_C item in, 4-37 
DDIF$_HRV_ESC_RATIO_D item in, 4-37 
DDIF$_HRV_ESC_RATIO_N item in, 4-37 
DDIF$_HRV_RESET_VALUE item in, 4-37 
DDIF$_HRV_RESET_VALUE_C item in, 4-37 
DDIF$_HRV_RESET_VARIABLE item in, 4-37 
DDIF$_IDU aggregate, 4-38 to 4-40 
DDIF$_IDU_BITS_PER_PIXEL item in, 4-40 
DDIF$_IDU_COMPRESSION_PARAMS item in, 
4-39 
DDIF$_IDU_COMPRESSION_TYPE item in, 4-39 
DDIF$_IDU_DATA_OFFSET item in, 4-39 
DDIF$_IDU_NUMBER_OF_LINES item in, 4-39 
DDIF$_IDU_PIXELS_PER_LINE item in, 4-38 
DDIF$_IDU_PIXEL_ORDER item in, 4-40 
DDIF$_IDU_PIXEL_STRIDE item in, 4-39 
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DDIF$_IDU aggregate (Cont.) 
DDIF$_IDU_PLANE_DATA item in, 4-40 
DDIF$_IDU_PRIVATE_CODING_ATTR item in, 

4-38 
DDIF$_IDU_SCANLINE_STRIDE item in, 4-39 
items in, 4—-38t 

DDIF$_IMG aggregate, 4-41 | 
DDIF$_IMG_CONTENT item in, 4—41 
items in, 4-41t 

DDIF$_LG1 aggregate, 4-42 
DDIF$_LG1_PAGE_DESCRIPTIONS item in, 4-42 
DDIF$_LG1_PRIVATE_DATA item in, 4—42 
items in, 4—-42t 

DDIF$_LIN aggregate, 4-43 to 4-44 
DDIF$_LIN_DRAW_PATTERN item in, 4-44 
DDIF$_LIN_FLAGS item in, 4-43 
DDIF$_LIN_PATH item in, 4-44 
DDIF$_LIN_PATH_C item in, 4-44 
items in, 4—43t 

DDIF$_LL1 aggregate, 4-45 to 4—49 
DDIF$_LL1_BREAK_AFTER item in, 4-47 
DDIF$_LL1_BREAK_BEFORE item in, 4-46 
DDIF$_LL1_BREAK_WITHIN item in, 4-47 
DDIF$_LL1_GALLEY_SELECT item in, 4-46 
DDIF$_LL1_INITIAL_DIRECTIVE item in, 4-46 
DDIF$_LL1_INITIAL_INDENT item in, 4-47 
DDIF$_LL1_INITIAL_INDENT_C item in, 4-47 
DDIF$_LL1_LEADING_CONSTANT item in, 4—48 
DDIF$_LL1_LEADING_CONSTANT_C item in, 

4-48 
DDIF$_LL1_LEADING_RATIO_D item in, 4-48 
DDIF$_LL1_LEADING_RATIO_N item in, 4-48 
DDIF$_LL1_LEFT_INDENT item in, 4-47 
DDIF$_LL1_LEFT_INDENT_C item in, 4—47 
DDIF$_LL1_RIGHT_INDENT item in, 4-48 
DDIF$_LL1_RIGHT_INDENT_C item in, 4-47 
DDIF$_LL1_SPACE_AFTER item in, 4-48 
DDIF$_LL1_SPACE_AFTER_C item in, 4-48 
DDIF$_LL1_SPACE_BEFORE item in, 4—48 
DDIF$_LL1_SPACE_BEFORE_C item in, 4-48 
DDIF$_LL1_TAB_ STOPS item in, 4-49 
items in, 4—45t 

DDIF$_LS1 aggregate, 4—50 to 4-51 
DDIF$_LS1_LAYOUT item in, 4-51 
DDIF$_LS1_LAYOUT_C item in, 4~-50 
items in, 4—50t 

DDIF$_LSD aggregate, 4-52 to 4-53 
DDIF$_LSD_NUMBER item in, 4-52 
DDIF$_LSD_PATTERN item in, 4-52, 4-129 
DDIF$_LSD_PRIVATE_DATA item in, 4-53 
items in, 4—52t : 

DDIF$_LW1 aggregate, 4-54 to 4-56 
DDIF$_LW1_HYPHENATION_FLAGS item in, 

4-55 
DDIF$_LW1_MAXIMUM_HYPH_LINES item in, 
4-56 
DDIF$_LW1_MAXIMUM_ORPHAN_ SIZE item in, 
4-56 
DDIF$_LW1_MAXIMUM_WIDOW_ SIZE item in, 
4-56 
DDIF$_LW1_QUAD_FORMAT item in, 4—55 
DDIF$_LW1_WRAP_FORMAT item in, 4-55 
items in, 4—-54t 

DDIF$_OCC aggregate, 4-57 to 4-58 
DDIF$_OCC_OCCURRENCE_C item in, 4-57 
DDIF$_OCC_STRUCTURE_ELEMENT item in, 

4-58 


DDIF$_OCC aggregate (Cont.) 


DDIF$_OCC_STRUCTURE_ELEMENT_C item in, 
4-58 
items in, 4-57t 
DDIF$_PGD aggregate, 4-59 to 4~—60 
DDIF$_PGD_DESC item in, 4-60 
DDIF$_PGD_DESC_C item in, 4-60 
DDIF$_PGD_LABEL item in, 4-59 
DDIF$_PGD_PRIVATE_DATA item in, 4-59 
items in, 4—59t 
DDIF$_PGL aggregate, 4-61 to 4-63 
DDIF$_PGL_CONTENT item in, 4-63 
DDIF$_PGL_LAYOUT_ID item in, 4-62 
DDIF$_PGL_ORIENTATION item in, 4—63 
DDIF$_PGL_PROTOTYPE item in, 4-63 
DDIF$_PGL_SIZE_X_NOM item in, 4-62 
DDIF$_PGL_SIZE_X_NOM_C item in, 4-62 
DDIF$_PGL_SIZE_X_SHR item in, 4-62 
DDIF$_PGL_SIZE_X_SHR_C item in, 4-62 
DDIF$_PGL_SIZE_X_STR item in, 4-62 
DDIF$_PGL_SIZE_X_STR_C item in, 4-62 
DDIF$_PGL_SIZE_Y_NOM item in, 4-62 
DDIF$_PGL_SIZE_Y_NOM_C item in, 4-62 
DDIF$_PGL_SIZE_Y_SHR item in, 4-63 
DDIF$_PGL_SIZE_Y_SHR_C item in, 4-63 
DDIF$_PGL_SIZE_Y_STR item in, 4-63 
DDIF$_PGL_SIZE_Y_STR_C item in, 4-62 
items in, 4-61t 
DDIF$_PGS aggregate, 4-64 to 4-65 
DDIF$_PGS_SELECT_PAGE_LAYOUT item in, 
4-65 
DDIF$_PGS_SELECT_PAGE_LAYOUT_C item in, 
4-65 
DDIF$_PGS_SIDE_CRITERIA item in, 4-64 
items in, 4-64t 
DDIF$_PHD aggregate, 4-66 
DDIF$_PHD_DESCRIPTION item in, 4-66 
DDIF$_PHD_NUMBER item in, 4-66 
DDIF$_PHD_PRIVATE_DATA item in, 4-66 
items in, 4—66t 
DDIF$_PTD aggregate, 4-67 to 4-69 
DDIF$_PTD_DEFN_C item in, 4-68 
DDIF$_PTD_NUMBER item in, 4-67 
DDIF$_PTD_PAT_COLORS item in, 4-69 
DDIF$_PTD_PAT_NUMBER item in, 4-68 
DDIF$_PTD_PRIVATE_DATA item in, 4-69 
DDIF$_PTD_RAS_PATTERN item in, 4-69 
DDIF$_PTD_SOL_COLOR_B item in, 4-68 
DDIF$_PTD_SOL_COLOR_C item in, 4-68 
DDIF$_PTD_SOL_COLOR_G item in, 4-68 
DDIF$_PTD_SOL_COLOR_R item in, 4-68 
items in, 4-67t 
DDIF$_PTH aggregate, 4-70 to 4-73 
DDIF$_PTH_ARC_CENTER_X item in, 4-72 
DDIF$_PTH_ARC_CENTER_X_C item in, 4~72 
DDIF$_PTH_ARC_CENTER_Y item in, 4-72 
DDIF$_PTH_ARC_CENTER_Y_C item in, 4~72 
DDIF$_PTH_ARC_EXTENT item in, 4-73 
DDIF$_PTH_ARC_EXTENT_C item in, 4-73 
DDIF$_PTH_ARC_RADIUS_DELTA_Y item in, 
4-73 
DDIF$_PTH_ARC_RADIUS_DELTA_Y_C item in, 
4-72 
DDIF$_PTH_ARC_RADIUS_X item in, 4—-72 
DDIF$_PTH_ARC_RADIUS_X_C item in, 4-72 
DDIF$_PTH_ARC_ROTATION item in, 4—73 
DDIF$_PTH_ARC_ROTATION_C item in, 4-73 


DDIF$_PTH aggregate (Cont.) 
DDIF$_PTH_ARC_START item in, 4~73 
DDIF$_PTH_ARC_START_C item in, 4-73 
DDIF$_PTH_BEZ_PATH item in, 4-72 
DDIF$_PTH_BEZ_PATH_C item in, 4-72 
DDIF$_PTH_C item in, 4-71 
DDIF$_PTH_LIN_PATH item in, 4-71 
DDIF$_PTH_LIN_PATH_C item in, 4-71 
DDIF$_PTH_ REFERENCE item in, 4-73 
items in, 4-70t 

DDIF$_PVT aggregate, 4-74 to 4-75 
DDIF$_PVT_DATA item in, 4~75 
DDIF$_PVT_DATA_C item in, 4-75 
DDIF$_PVT_NAME item in, 4-75 
DDIF$_PVT_REFERENCE_ERF_INDEX item in, 

4-75 
items in, 4—74t 

DDIF$_RCD aggregate, 4-76 
DDIF$_RCD_CONTENTS item in, 4-76 
DDIF$_RCD_TAG item in, 4-76 
DDIF$_RCD_TYPE item in, 4-76 
items in, 4~76t 

DDIF$_RGB aggregate, 4—77 
DDIF$_RGB_BLUE_VALUE item in, 4-77 
DDIF$_RGB_GREEN_VALUE item in, 4-77 
DDIF$_RGB_LUT_INDEX item in, 4—77 
DDIF$_RGB_RED_VALUE item in, 4-77 
items in, 4-77t 

DDIF$_SEG aggregate, 4-78 
DDIF$_SEG_CONTENT item in, 4~—80 
DDIF$_SEG_GENERIC_LAYOUT item in, 4-79 
DDIF$_SEG_ID item in, 4-78 
DDIF$_SEG_SEGMENT_TYPE item in, 4-79 
DDIF$_SEG_SPECIFIC_ATTRIBUTES item in, 

4-79 
DDIF$_SEG_SPECIFIC_LAYOUT item in, 4~79 
DDIF$_ SEG_USER_LABEL item in, 4-79 

DDIF$_SFT aggregate, 4-81 
DDIF$_SFT_DIRECTIVE item in, 4-82 

DDIF$ _SFV aggregate, 4-83 to 4-84 
DDIF$_SFV_C item in, 4-84 
DDIF$_SFV_ESC_CONSTANT item in, 4-84 
DDIF$_SFV_ESC_CONSTANT_C item in, 4-84 
DDIF$_SFV_ESC_RATIO_D item in, 4-84 
DDIF$_SFV_ESC_RATIO_N item in, 4-84 
DDIF$_SFV_RESET_VALUE item in, 4-84 
DDIF$_SFV_RESET_VALUE_C item in, 4-84 
DDIF$_SFV_RESET_VARIABLE item in, 4-84 

DDIF$_SGA aggregate, 4~85 to 4-153 
DDIF$_SGA_ALT_ PRESENTATION item in, 4-101 
DDIF$_SGA_BINDING_DEFNS item in, 4-91 
DDIF$_SGA_COMPUTE_C item in, 4-92 
DDIF$_SGA_CONTENT_CATEGORY item in, 

4—90 
DDIF$_SGA_CONTENT_DEFNS item in, 4-116 
DDIF$_SGA_CONTENT_STREAMS item in, 4-90 
DDIF$_SGA_CPTCPY_ERF_INDEX item in, 4-93 
DDIF$_SGA_CPTCPY_TARGET item in, 4-93 
DDIF$_SGA_CPTFNC_NAME item in, 4-96 
DDIF$_SGA_CPTFNC_PARAMETERS item in, 

4-96 
DDIF$_SGA_CPTVAR_VARIABLE item in, 4-94 
DDIF$_SGA_CPTXRF_ERF_INDEX item in, 4-95 
DDIF$_SGA_CPTXRF_TARGET item in, 4-95 
DDIF$_SGA_CPTXRF_VARIABLE item in, 4~—95 
DDIF$_SGA_FONT_DEFNS item in, 4-112 
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DDIF$_SGA aggregate (Cont.) 


DDIF$_SGA_FRMFXD_POSITION_X item in, 
4-147 7 
DDIF$_SGA_FRMFXD_POSITION_X_C item in, 
4-147 
DDIF$_SGA_FRMFXD_POSITION_Y item in, 
4-147 
DDIF$_SGA_FRMFXD_POSITION_Y_C item in, 
4-147 
DDIF$_SGA_FRMGLY_HORIZONTAL item in, 
4-149 
DDIF$_SGA_FRMGLY_VERTICAL item in, 4-149 
DDIF$_SGA_FRMINL_BASE_OFFSET item in, 
4-148 
DDIF$_SGA_FRMINL_BASE_OFFSET_C item in, 
4-148 
DDIF$_SGA_FRMMAR_BASE_OFFSET item in, 
4-150 
DDIF$_SGA_FRMMAR_BASE_OFFSET_C item in, 
4-150 
DDIF$_SGA_FRMMAR_HORIZONTAL item in, 
4-151 
DDIF$_SGA_FRMMAR_NEAR_OFFSET item in, 
4-150 
DDIF$_SGA_FRMMAR_NEAR_OFFSET._C item in, 
4-150 
DDIF$_SGA_FRM_BOX_LL_X item in, 4-141 
DDIF$_SGA_FRM_BOX_LL X Citemin, 4-141 
DDIF$_SGA_FRM_BOX_LL_Y item in, 4-141 
DDIF$_SGA_FRM_BOX_LL_Y_C item in, 4-141 
DDIF$_SGA_FRM_BOX_UR_X item in, 4-141 
DDIF$_SGA_FRM_BOX_UR_X_C item in, 4-141 
DDIF$_SGA_FRM_BOX_UR_Y item in, 4-142 
DDIF$_SGA_FRM_BOX_UR_Y_C item in, 4-141 
DDIF$_SGA_FRM_CLIPPING item in, 4-144 
DDIF$_SGA_FRM_FLAGS item in, 4-140 
DDIF$_SGA_FRM_OUTLINE item in, 4-143 
DDIF$_SGA_FRM_POSITION_C item in, 4-146 
DDIF$_SGA_FRM_TRANSFORM item in, 4-152 
DDIF$_SGA_GLY_ATTRIBUTES item in, 4-133 
DDIF$ SGA _IMG_BITS_PER_COMP item in, 
4-138 
DDIF$_SGA_IMG_BRT_POLARITY item in, 4-135 
DDIF$_SGA_IMG_COMP_SPACE_ORG item in, 
4-137 
DDIF$_SGA_IMG_COMP_WAVELENGTH item in, 
4-136 
DDIF$_SGA_IMG_COMP_WAVELENGTH_C item 
in, 4-136 
DDIF$_SGA_IMG_GRID_TYPE item in, 4-135 
DDIF$_SGA_IMG_LINE_PROGRESSION item in, 
4134 
DDIF$_SGA_IMG_LOOKUP_TABLES item in, 
4-136 
DDIF$_SGA_IMG_LOOKUP_TABLES C item in, 
4-136 
DDIF$_SGA_IMG_LP_PIXEL_DIST item in, 4-134 
DDIF$_SGA_IMG_NUMBER_OF_COMP item in, 
4-138 
DDIF$_SGA_IMG_PIXEL_PATH item in, 4-134 
DDIF$_SGA_IMG_PLANES_PER_PIXEL item in, 
4-138 
DDIF$_SGA_IMG_PLANE_SIGNIF item in, 4-138 
DDIF$_SGA_IMG_PP_PIXEL_DIST item in, 4-134 
DDIF$_SGA_IMG_PRIVATE_DATA item in, 4-134 
DDIF$_SGA_IMG_SPECTRAL_MAPPING item in, 
4-135 
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DDIF$_SGA aggregate (Cont.) 


DDIF$_SGA_ITEM_CHANGE_LIST item in, 4-153 
DDIF$_SGA_LANGUAGE item in, 4-98 
DDIF$_SGA_LAYGLY_LAYOUT item in, 4-104 
DDIF$_SGA_LAYGLY_WRAP item in, 4-104 
DDIF$_SGA_LAYOUT_C item in, 4-103 
DDIF$_SGA_LAYPOS_TEXT_POSITION item in, 
4-111 
DDIF$_SGA_LAYPTH_FORMAT item in, 4-106 
DDIF$_SGA_LAYPTH_H_ALIGN item in, 4-107 
DDIF$_SGA_LAYPTH_ORIENTATION item in, 
4-106 
DDIF$_SGA_LAYPTH_ORIENTATION_C item in, 
4-106 
DDIF$_SGA_LAYPTH_PATH item in, 4-105 
DDIF$_SGA_LAYPTH_V_ALIGN item in, 4-108 
DDIF$_SGA_LAYREL_H_CONSTANT item in, 
4-109 
DDIF$_SGA_LAYREL_H_CONSTANT_C item in, 
4-109 
DDIF$_SGA_LAYREL_H_RATIO_D item in, 4-109 
DDIF$_SGA_LAYREL_H_RATIO_N item in, 4-109 
DDIF$_SGA_LAYREL_V_CONSTANT item in, 
4-110 
DDIF$_SGA_LAYREL_V_CONSTANT_C item in, 
4-110 
DDIF$_SGA_LAYREL_V_RATIO_D item in, 4-110 
DDIF$_SGA_LAYREL_V_RATIO_N item in, 4-109 
DDIF$_SGA_LEGEND_UNIT_D item in, 4-99 
DDIF$_SGA_LEGEND_UNIT_NAME item in, 4-99 
DDIF$_SGA_LEGEND_UNIT_N item in, 4-99 
DDIF$_SGA_LINE_STYLE_DEFNS item in, 4—115 
DDIF$_SGA_LIN_END_ FINISH item in, 4-130 
DDIF$_SGA_LIN_END_SIZE item in, 4-130 
DDIF$_SGA_LIN_END_SIZE_C item in, 4-130 
DDIF$_SGA_LIN_END_START item in, 4-129 
DDIF$_SGA_LIN_INTERIOR_PATTERN item in, 
4-130 
DDIF$_SGA_LIN_JOIN item in, 4-130 
DDIF$_SGA_LIN_MASK_PATTERN item in, 4-129 
DDIF$_SGA_LIN_MITER_LIMIT_D item in, 4-130 
DDIF$_SGA_LIN_MITER_LIMIT_N item in, 4-130 
DDIF$_SGA_LIN_PATTERN_SIZE item in, 4-129 
DDIF$_SGA_LIN_PATTERN_SIZE_C item in, 
4-129 
DDIF$_SGA_LIN_STYLE item in, 4-128 
DDIF$_SGA_LIN_WIDTH item in, 4-128 
DDIF$_SGA_LIN_WIDTH_C item in, 4-128 
DDIF$_SGA_MKR_MASK_PATTERN item in, 
4-132 
DDIF$_SGA_MKR_SIZE item in, 4-132 
DDIF$_SGA_MKR_SIZE_C item in, 4-132 
DDIF$_SGA_MKR_STYLE item in, 4-132 
DDIF$_SGA_PATH_DEFNS item in, 4-114 
DDIF$_SGA_PATTERN_DEFNS item in, 4-113 
DDIF$_SGA_PRIVATE_DATA item in, 4—90 
DDIF$_SGA_SEGMENT_TAGS item in, 4~91 
DDIF$_SGA_STRUCTURE_DESC item in, 4-97 
DDIF$_SGA_STRUCTURE_DESC _C item in, 
4-97 
DDIF$_SGA_TXT_DEC_ALIGNMENT item in, 
4-125 
DDIF$_SGA_TXT_DIRECTION item in, 4-124 
DDIF$_SGA_TXT_FONT item in, 4-120 
DDIF$_SGA_TXT_HEIGHT item in, 4-123 
DDIF$_SGA_TXT_HEIGHT_C item in, 4-123 
DDIF$_SGA_TXT_LEADER_ALIGN item in, 4-126 


DDIF$_SGA aggregate (Cont.) 


DDIF$_SGA_TXT_LEADER_BULLET item in, 
4-126 
DDIF$_SGA_TXT_LEADER_SPACE item in, 
4-126 
DDIF$_SGA_TXT_LEADER_SPACE_C item in, 
4-126 
DDIF$_SGA_TXT_LEADER_STYLE item in, 4-126 
DDIF$_SGA_TXT_MASK_PATTERN item in, 
4-119 
DDIF$_SGA_TXT_PAIR_KERNING item in, 4-127 
DDIF$_SGA_TXT_RENDITION item in, 4—122 
DDIF$_SGA_TXT_SET_SIZE_D item in, 4-123 
DDIF$_SGA_TXT_SET_SIZE_N item in, 4-123 
DDIF$_SGA_TYPE_DEFNS item in, 4—117 
DDIF$_SGA_UNITS_PER_MEASURE item in, 
4—100 
DDIF$_SGA_UNIT_NAME item in, 4-100 
items in, 4-86t 
DDIF$_SGB aggregate, 4-154 to 4-159 
DDIF$_SGB_COM_STRING_EXPR item in, 4-158 
DDIF$_SGB_COM_STRING_EXPR_C item in, 
4-158 
DDIF$_SGB_CTR_INIT item in, 4-157 
DDIF$_SGB_CTR_INIT_C item in, 4-157 
DDIF$_SGB_CTR_STYLE item in, 4-157 
DDIF$_SGB_CTR_TRIGGER_C item in, 4~—156 
DDIF$_SGB_CTR_TYPE item in, 4-157 
DDIF$_SGB_RCD_LIST item in, 4-159 
DDIF$_SGB_VARIABLE_NAME item in, 4-154 
DDIF$_SGB_VARIABLE_VALUE_C item in, 4-155 
items in, 4-154t 
DDIF$_TBS aggregate, 4-160 to 4-161 
DDIF$_TBS_HORIZONTAL_POSITION item in, 
4-160 
DDIF$_TBS_HORIZONTAL_POSITION_C item in, 
4-160 
DDIF$_TBS_LEADER item in, 4-161 
DDIF$_TBS_TYPE item in, 4-161 
items in, 4-160t 
DDIF$_TRN aggregate, 4-162 to 4-163 
DDIF$_TRN_PARAMETER item in, 4-163 
DDIF$_TRN_PARAMETER_C item in, 4-163 
items in, 4—162t 
DDIF$_TXT aggregate, 4-164 
DDIF$_TXT_CONTENT item in, 4-164 
DDIF$_TYD aggregate, 4-165 to 4-166 
DDIF$_TYD_ATTRIBUTES item in, 4-165 
DDIF$_TYD_LABEL item in, 4-165 
DDIF$_TYD_PARENT item in, 4—165 
DDIF$_TYD_PRIVATE_DATA item in, 4-166 
items in, 4-165t 
DDIF$_USER_CONTEXT aggregate item, defined, 
4-1 
DDIF (DIGITAL Document Interchange Format) 
analyzing files encoded in, 2-8 
VMS _ RMS support of, F—1 
DDIF aggregate hierarchy, 1—6fig 
DDIF aggregates, list of, 1-5 
DDIF back end, 2-3 
conversion restrictions, 2-3 
data mapping in, 2-3 
DDiFDocument syntax diagram, B-5 
DDIF front end, 2-1 
conversion restrictions, 2—1 
data mapping in, 2-1 
document syntax errors in, 2—1 


DDIF front end (Cont.) 


external file references in, 2-1 
DDIF initial values, 1-9 
DDIF processing options, 1-13 
attribute inheritance, 1-14 
discard segments, 1-17 
evaluate content, 1-15 
computed content, 1-16 
content definitions, 1-16 
content references, 1-16 
retain definitions, 1-15 
DDIF standard aggregates, 1—5t 
DDIF tags, 1-7 
DDIF-to-Text RMS extension, F—1 
DDIS built-in constructors 
SEQUENCE, B-2 
SEQUENCE OF, B-2 
DDIS built-in operators 
ANY, B-3 
assignment, B-3 
CHOICE, B-3 
comment, B-3 
DEFAULT, B-3 
named number, B-3 
OPTIONAL, B-3 
DDIS built-in primitives 
BIT STRING, B-1 
BOOLEAN, B-1 
EXTERNAL, B-2 
FLOATING-POINT, B-1 
INTEGER, B-1 
NULL, B-1 
OBJECT IDENTIFIER, B-2 
OCTET STRING, B—1 
DDIS defined types 
Character-String, B-4 
Latin1-String, B-4 
ObjectDescriptor, B-4 
Text-String, B-4 
DDIS encoding 
definition of, 1-2 
Decimal string construct 
See ExpressionList syntax diagram and CFE 
expressions, conversion 
Decimal-string syntax diagram 
See ExpressionList syntax diagram 
DEFAULT built-in operator, defined, B-3 
Default values 
for CDA, 1-4 
DELETE AGGREGATE routine, 8-58 
DELETE ROOT AGGREGATE routine, 8-60 
Dep-cross syntax diagram 
See ExpressionList syntax diagram 
Dep-db syntax diagram 
See ExpressionList syntax diagram 
Dep-ddb syntax diagram 
See ExpressionList syntax diagram 
Depreciation, declining balance construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Depreciation, declining balance with crossover to 
straight line construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
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Depreciation, straight line construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Depreciation, sum of year’s digits construct 


See ExpressionList syntax diagram and CFE 
expressions, financial 
Depreciation double declining balance construct 


See ExpressionList syntax diagram and CFE 
expressions, financial 

Dep-sline syntax diagram 

See ExpressionList syntax diagram 
Dep-soyd syntax diagram 

See ExpressionList syntax diagram 
-d format qualifier 

for the cdoc command, 2-16 
Diff-day syntax diagram 

See ExpressionList syntax diagram 
Diff-hour syntax diagram 


See ExpressionList syntax diagram 
Diff-min syntax diagram 

See ExpressionList syntax diagram 
Diff-month syntax diagram 

See ExpressionList syntax diagram 
Diff-sec syntax diagram 

See ExpressionList syntax diagram 
Diff-week syntax diagram 

See ExpressionList syntax diagram 
Diff-year syntax diagram 

See ExpressionList syntax diagram 
DIGITAL Document Interchange Format 


See DDIF 
Directive 
hard, 4-34 
hard value, 4-36 to 4-37 
soft, 4-81 
soft value, 4-83 to 4-84 
values for, 4—34t, 4-81t 
Directive syntax diagram, B—10 
Discard segments processing options, 1-17 
Discount construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Disjoint ranges, 5-55 
See also Ranges 
Divide syntax diagram 
See ExpressionList syntax diagram 
Division construct 
See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
Document 
creating for output, 8-39 
describing the encoding of, 4-12 
distinguishing versions of, 4-14 
indicating the name of, 4-17 
reading from a stream, 8-97 
representing the encoding software of, 4-17 
returning position in, 8-148 
returning size of, 8-148 
specifying external style guide for, 4—15 
specifying file references in, 4-14 
specifying parameters for, 4-12 
specifying private information for, 4-13 
specifying processing languages in, 4-14 
specifying processing restrictions for, 4-14 
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Document (Coni.) 

specifying the author of, 4-14 

specifying the content of, 4-12 

specifying the title of, 4-13 

specifying version date of, 4-14 

structure of, 4-1 

testing the compatibility of versions for, 4-16 

writing, 8-153 
Document content aggregate, 4-78 

See also DDIF$_SEG aggregate 

generic layout item in, 4-79 

items in, 4—78t 

segment attribute item in, 4-79 

segment content item in, 4-80 

segment identifier item in, 4-78 

segment type item in, 4-79 

segment user label item in, 4-79 

specific layout item in, 4-79 
Document descriptor aggregate, 4-16 to 4-17 

See also DDIF$_DSC aggregate 

items in, 4—-16t 

major version item in, 4-16 

minor version item in, 4-16 

product identifier item in, 4-17 

product name item in, 4-17 
DocumentDescriptor syntax diagram, B-5, C—1 
Document header aggregate, 4-13 

See also DDIF$_DHD aggregate 

author item in, 4-14 

conformance tags item in, 4-14 

date item in, 4-14 

external references item in, 4-14 

items in, 4—-13t 

language item in, 4-15 

languages indicator item in, 4-14 

private header data item in, 4-13 

style guide item in, 4-15 

title item in, 4—13 

version item in, 4-14 
DocumentHeader syntax diagram, B-6, C-2 
Document root segment syntax diagram, B-6 
Document scope 

completing, 8-112 

entering, 8-62 
Document syntax errors 

in DDIF front end, 2-1 

in Text front end, 2-3 
domain$read_format entry point routine, 11-10 
domain$write_format entry point, 11-15 
$2D tag, defined, 4-90 
DTIF$K_MAJOR_VERSION literal, 5-23 
DTIF$K_MINOR_VERSION literal, 5-23 
dtifSwrite_format, 8-16 
DTIF$_AGGREGATE_TYPE aggregate item, 5—1 
DTIF$_ARD aggregate, 5-2 to 5-3 

DTIF$_ARD_DESCRIPTION item in, 5-2 

DTIF$_ARD_ELEM_TYPE_SIZE item in, 5-3 

DTIF$_ARD_ELEM_TYPE_SIZE_C item in, 5-2 

DTIF$_ARD_VALUES item in, 5-3 

DTIF$_ARD_X_DIMENSION item in, 5-3 

DTIF$_ARD_Y_DIMENSION item in, 5-3 

DTIF$_ARD_Z_ DIMENSION item in, 5-3 

items in, 5-2 
DTIF$_CAT aggregate, 5-4 to 5-9 

DTIF$_CAT_APPL_PRIVATE item in, 5-5 

DTIF$_CAT_COLUMN_HDR item in, 5-8 


DTIF$_CAT aggregate (Cont.) 


DTIF$_CAT_COMPUTED_BY item in, 5-5 
DTIF$_CAT_DATA_LENGTH item in, 5-8 
DTIF$_CAT_DATA_TYPE item in, 5-8 
DTIF$_CAT_DEFAULT_VALUE item in, 5-6 
DTIF$_CAT_DEFAULT_VALUE_C item in, 5-5 
DTIF$_CAT_DESCRIPTION item in, 5-5 
DTIF$_CAT_FLAGS item in, 5-8 
DTIF$_CAT_FORMATS item in, 5-5 
DTIF$_CAT_GENERIC_REF item in, 5-5 
DTIF$_CAT_ID item in, 5-5 
DTIF$_CAT_MISSING_VALUE item in, 5-7 
DTIF$_CAT_NAME item in, 5-4 
DTIF$_CAT_QUERY_NAME item in, 5-7 
DTIF$_CAT_SCALE_ FACTOR item in, 5-8 
items in, 5-4 

DTIF$_CCD aggregate, 5-10 to 5-11 
DTIF$_CCD_COLUMN item in, 5—10 
DTIF$_CCD_FLAGS item in, 5-10 
DTIF$_CCD_ROW item in, 5-10 
items in, 5-10 

DTIF$_CFT aggregate, 5-12 
DTIF$_CFT_IMAGINARY_PART item in, 5-12 
DTIF$_CFT_REAL_PART item in, 5-12 
items in, 5-12 

DTIF$_CLD aggregate, 5-13 to 5-17 
DTIF$_CLD_APPL_PRIVATE item in, 5-15 
DTIF$_CLD_COL_NUM item in, 5-14 
DTIF$_CLD_DESCRIPTION item in, 5-15 
DTIF$_CLD_FORMATS item in, 5-15 
DTIF$_CLD_FORMULA_CFE item in, 5-16 
DTIF$_CLD_STATE item in, 5-14 
DTIF$_CLD_VALUE item in, 5-16 
DTIF$_CLD_VALUE_C item in, 5-15 
items in, 5-14 

DTIF$_CLR aggregate, 5-18 
DTIF$_CLR_RANGE_BEGIN item in, 5-18 
DTIF$_CLR_RANGE_END item in, 5-18 
items in, 5-18 

DTIF$_COR aggregate, 5-19 
DTIF$_COR_COL_BEGIN item in, 5-19 
DTIF$_COR_COL_END item in, 5-19 
items in, 5-19 

DTIF$_DAT aggregate, 5-20 to 5-21 
DTIF$_DAT_DATETIME item in, 5-20 
DTIF$_DAT_TIME_DIFF item in, 5-21 
DTIF$_DAT_TIME_DIFF_C item in, 5-20 
items in, 5-20 

DTIF$_DSC aggregate, 5-22 to 5-23 
DTIF$_DSC_ENCODE_MAJOR_VERSION item in, 

5-23 
DTIF$_DSC_ENCODE_MINOR_VERSION, 5-23 
DTIF$_DSC_MAJOR_VERSION item in, 5-22 
DTIF$_DSC_MINOR_VERSION item in, 5-22 
DTIF$_DSC_PRODUCT_IDENTIFIER item in, 
5-22 

DTIF$_DSC_PRODUCT_NAME item in, 5-22 
items in, 5-22 

DTIF$_DTF aggregate, 5-24 
DTIF$_DTF_DESCRIPTOR item in, 5-24 
DTIF$_DTF_HEADER item in, 5-24 
DTIF$_DTF_TABLES item in, 5-24 
items in, 5-24 

DTIF$_ERF aggregate, 5-25 to 5-26 
DTIF$_ERF_CONTROL item in, 5-26 
DTIF$_ERF_DATA_TYPE item in, 5-25 
DTIF$_ERF_DESCRIPTOR item in, 5-25 


DTIF$_ERF aggregate (Cont.) 


DTIF$_ERF_LABEL item in, 5-25 
DTIF$_ERF_LABEL_TYPE item in, 5-26 
items in, 5-25 


DTIF$_EXT aggregate, 5-27 to 5-28 


DTIF$_EXT_DATA_VALUE_DESCRIPTOR item in, 
5-27 

DTIF$_EXT_DIRECT_REFERENCE item in, 5-27 

DTIF$_EXT_ENCODING item in, 5-28 

DTIF$_EXT_ENCODING_C item in, 5-27 

DTIF$_EXT_ENCODING_L item in, 5-28 

DTIF$_EXT_INDIRECT_REFERENCE item in, 
5-27 

items in, 5-27 


DTIF$_FM! aggregate, 5-29 to 5-42 


DTIF$_FMI_ALIGNMENT item in, 5-40 
DTIF$_FMI_BORDER item in, 5—40 
DTIF$_FMI_C item in, 5-30 
DTIF$_FMI_DATEDS _EDITSTR item in, 5-38 
DTIF$_FMI_DATEID_EDITSTR_ID item in, 5-38 
DTIF$_FMl_DATSTD_ORDER item in, 5-37 
DTIF$_FMI_DATSTD_TYPE item in, 5~37 
DTIF$_FMI_DAT_C item in, 5-36 
DTIF$_FMI_DIRECTION item in, 5-40 
DTIF$_FMI_FLAGS item in, 5-38 
DTIF$_FMI_LANG_ID item in, 5-39 
DTIF$_FMi_NUMEDS_EDITSTR item in, 5-34 
DTIF$_FMI_NUMEID_EDITSTR_ID item in, 5-34 
DTIF$_FMi_NUMSTD_DIGITS item in, 5—34 
DTIF$_FMl_NUMSTD_FRAC item in, 5-34 
DTIF$_FMI_NUMSTD_TYPE item in, 5-32 
DTIF$_FMI_NUM_C item in, 5-31 
DTIF$_FMI_NUM_DATATYPE item in, 5-31 
DTIF$_FMI_NUM_RNDTRUNC item in, 5-34 
DTIF$_FMI_TXTEDS_EDITSTR item in, 5-36 
DTIF$_FMI_TXTEID_EDITSTR_ID item in, 5-36 
DTIF$_FMI_TXTSTD_TYPE item in, 5-35 
DTIF$_FMI_UNIT_DESC item in, 5-40 
DTIF$_FMI_WIDTH item in, 5-39 
DTIF$_FMI_WINDOW_ID item in, 5-30 
DTIF$_TXT_C item in, 5-35 

items in, 5-29 


DTIF$_HDR aggregate, 5-43 to 5-45 


DTIF$_HDR_DATE item in, 5-43 

DTIF$_HDR_EXTERNAL_REFERENCES item in, 
5-44 

DTIF$_HDR_GENERIC_COLUMNS item in, 5-44 

DTIF$_HDR_LANGUAGES item in, 5-44 

DTIF$_HDR_LANGUAGES C item in, 5-44 

DTIF$_HDR_LANGUAGE_PREF_TABLES item in, 
5-44 

DTIF$_HDR_PRIVATE_DATA item in, 5-43 

DTIF$_HDR_TITLE item in, 5-43 

items in, 5-43 


DTIF$_LPT aggregate, 5-46 to 5-50 


DTIF$_LPT_COLLATE_SEQ item in, 5—49 
DTIF$_LPT_COLLATE_TABLE item in, 5-49 
DTIF$_LPT_EDITSTRS item in, 5-48 
DTIF$_LPT_ITEMS item in, 5—47 
DTIF$_LPT_LANGUAGE_INDEX item in, 5-46 
items in, 5-46 


DTIF$_NES aggregate, 5-51 


DTIF$_NES_DEFN item in, 5-51 
DTIF$_NES_ NAME item in, 5-51 
items in, 5-51 


DTIF$_NMR aggregate, 5-52 


DTIF$_NMR_NAMEDRANGE item in, 5-52 
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DTIF$_NMR aggregate (Cont.) 
items in, 5-52 

DTIF$_NVL 
items in, 5-53 

DTIF$_NVL aggregate, 5-53 to 5-54 
DTIF$_NVL_NAME item in, 5-53 
DTIF$_NVL_VALUE item in, 5-54 
DTIF$_NVL_VALUE_C item in, 5-53 

DTIF$_READ_format, 8-15 

DTIF$_RNG aggregate, 5-55 to 5-56 
DTIF$_RNG_NAME item in, 5-55 
DTIF$_RNG_REGION item in, 5-56 
DTIF$_RNG_SORT_KEYNUM item in, 5-56 
DTIF$_RNG_TYPE item in, 5-55 
items in, 5-55 

DTIF$_ROW aggregate, 5-57 to 5-58 
DTIF$_ROW_APPL_PRIVATE item in, 5-57 
DTIF$_ROW_CELLS item in, 5-58 
DTIF$_ROW_FLAGS item in, 5-58 
DTIF$_ROW_FORMATS item in, 5-57 
DTIF$_ROW_NUM item in, 5-57 
items in, 5-57 

DTIF$_RWR aggregate, 5-59 
DTIF$_RWR_ROW_BEGIN item in, 5-59 
DTIF$_RWR_ROW_END item in, 5-59 
items in, 5-59 

DTIF$_TBL aggregate, 5-60 to 5-61 
DTIF$_TBL_APPL_PRIVATE item in, 5-61 
DTIF$_TBL_MAX_COLS item in, 5-60 
DTIF$_TBL_MAX_ROWS item in, 5-61 
DTIF$_TBL_METADATA item in, 5-61 
DTIF$_TBL_ROWS item in, 5-61 
DTIF$_TBL_WINDOWS item in, 5-61 
items in, 5-60 

DTIF$_TMD aggregate, 5-62 to 5-64 
DTIF$_TMD_APPL_PRIVATE item in, 5-62 
DTIF$_TMD_COLUMNS item in, 5-63 
DTIF$_TMD_DEFAULT_FMTS item in, 5-63 
DTIF$_TMD_DESCRIPTION item in, 5-62 
DTIF$_TMD_FLAGS item in, 5-63 
DTIF$_TMD_ID item in, 5-62 
DTIF$_TMD_NAME item in, 5-62 
DTIF$_TMD_RANGES item in, 5-64 
DTIF$_TMD_SYMBOLS item in, 5-64 
items in, 5-62 

DTIF$_USER_CONTEXT aggregate item, defined, 

5-1 

DTIF$_VTX aggregate, 5-65 
DTIF$_VTX_VTEXT_LEN item in, 5-65 
DTIF$_VTX_VTEXT_STR item in, 5-65 
items in, 5-65 

DTIF$_WND aggregate, 5-66 to 5-68 
DTIF$_WND_ACTIVE_LOC item in, 5-67 
DTIF$_WND_APPL_PRIVATE item in, 5-66 
DTIF$_WND_CARDINAL_NUM item in, 5-67 
DTIF$_WND_DESCRIPTION item in, 5-67 
DTIF$_WND_FLAGS item in, 5-67 
DTIF$_WND_FORMATS item in, 5-67 
DTIF$ _WND_ID item in, 5-66 
DTIF$_WND_NAME item in, 5-66 
DTIF$_WND_RANGES item in, 5-67 
items in, 5-66 

DTIF application private aggregate, 5-27 to 5-28 
data value descriptor item in, 5-27 
direct reference item in, 5-27 
encoding indicator item in, 5-27 
encoding item in, 5-28 
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DTIF application private aggregate (Cont.) 
encoding length item in, 5-28 
indirect reference item in, 5-27 
items in, 5-27 
DTIF back end 
conversion restrictions, 2—4 
data mapping, 2-3 
external file references, 2-4 
overview, 2-3 
DTIF ceil coordinates 
absolute references to, 5—11 
relative references to, 5-11 
DTIF cell coordinates aggregate, 5-10 to 5-11 
column identifier item in, 5-10 
flags item in, 5-10 
items in, 5-10 
row identifier item in, 5-10 
DTIF cell range aggregate, 5-18 
items in, 5-18 
range begin item in, 5-18 
range end item in, 5-18 
DTIF column range aggregate, 5-19 
column begin item in, 5-19 
column end item in, 5-19 
items in, 5-19 
DTIF complex float aggregate, 5-12 
imaginary portion value item in, 5-12 
items in, 5-12 
real portion value item in, 5-12 
DTIF date and time aggregate, 5-20 to 5-21 
date and time item in, 5-20 
items in, 5-20 
time difference item in, 5-20 
DTIF document 
distinguishing versions of, 5-23 
encoding edit strings in, 7-4 
encoding expressions in, 6-53 
generic aggregate items 
DTIF$_AGGREGATE_TYPE, 5-1 
DTIF$_USER_CONTEXT, 5-1 
representing the encoding software of, 5-23 
specifying array values, 5-2 
specifying cell coordinates for, 5-10 
specifying cell data for, 5-13 
specifying cell ranges for, 5-18 
specifying column attributes for, 5-4 
specifying column ranges for, 5-19 
specifying complex floating-point values, 5-12 
specifying date and time values for, 5-20, 7-2 
specifying external references for, 5-44 
specifying format information for, 5-29 
specifying generic attributes for, 5-44 
specifying language preference tables for, 5-44, 
5-46 
specifying named edit strings for, 5-51 
specifying named ranges for, 5-52 
specifying named values for, 5-53, 7-22 
specifying natural and programming languages for, 
5-44 
specifying private data for, 5-27, 5-43 
specifying product identifier in, 5-22 
specifying product name in, 5-22 
specifying ranges for, 5-55 
specifying row ranges for, 5-59 
specifying rows for, 5-57 
specifying table definitions for, 5-60 
specifying table metadata for, 5-62 


DTIF document (Cont.) 
specifying table windows for, 5-66 
specifying the title of, 5-43 
specifying the version date of, 5-43 
specifying varying text string values, 5-65 
DTIF document aggregate 
language item in, 5—44 
product identifier item in, 5-22 
DTIF document descriptor aggregate, 5-22 to 5-23 
encoding major version indicator item in, 5-23 
encoding minor version indicator item in, 5-23 
items in, 5-22 
major version indicator item in, 5-22 
minor version indicator item in, 5-22 
product name item in, 5-22 
DTIF document header aggregate, 5-43 to 5-45 
date item in, 5-43 
external references item in, 5-44 
generic attributes item in, 5-44 
items in, 5-43 
language preference table item in, 5-44 
languages indicator item in, 5-44 
private header data item in, 5-43 
title item in, 5-43 
DTIF document root aggregate, 5-24 
document descriptor item in, 5-24 
document header item in, 5-24 
document tables item in, 5-24 
items in, 5-24 
DT!IFDocument syntax diagram, C—1 
DTIF external reference 
specifying data type of, 5-25 
specifying description of the data type of, 5-25 
specifying label for, 5-25 
specifying storage system of, 5-26 
specifying treatment of, 5-26 
DTIF external reference aggregate, 5-25 to 5-26 
control item in, 5-26 
items in, 5-25 
reference data type item in, 5-25 
reference descriptor item in, 5-25 
reference label item in, 5-25 
storage item in, 5-26 
DTIF front end 
conversion restrictions, 2~—2 
data mapping, 2-2 
external file references, 2—2 
overview, 2-2 
DTIF named value aggregate, 5-53 to 5-54 
items in, 5-53 
value data item in, 5-53, 5-54 
value name item in, 5-53 
DTIF named values 
specifying the name for, 5-53 
specifying the value data for, 5-53 
DTIF row range aggregate, 5-59 
items in, 5-59 
row begin data item in, 5-59 
row end data item in, 5-59 
DTIF syntax diagrams, C—1 to C-18 
DTIF tables 
See DTIF document 
See Table definition 
See Table metadata 
DTIF varying text aggregate, 5-65 
character string data item in, 5-65 
items in, 5-65 


DTIF varying text aggregate (Cont.) 


text length item in, 5-65 
dxvdoc command, 2-18 to 2-19 

-f format qualifier, 2-18 

-h paper-height qualifier, 2-19 

-O options qualifier, 2-19 

-t qualifier, 2-19 

-w paper-width qualifier, 2-19 


E 


EditStrBuff syntax diagram, E-1 
EditStrindex syntax diagram, C—12 
Edit string aggregate, 74 to 7-19 
edit string indicator item in, 7-5 
items in, 7-4 
major version item in, 7—4 
minor version item in, 7-4 
Edit strings 
See ESF edit strings 
EditString syntax diagram, E-1 
Ellipse 
See Arc 
$EN tag, defined, 4—30, 4-90 
ENTER SCOPE routine, 8-62 
Enumeration 
AngleRef, 1-1 
encoding of, 1-2 
expression, 1-2 
measurement, 1-3 
Eql syntax diagram 
See ExpressionList syntax diagram 
Equal to construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
ERASE ITEM routine, 8-76 
ERF 
See External reference; External reference 
aggregate 
Error conditions 
for cell values, 5-15 
Error construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
EscapementDirective syntax diagram, B—11 
Escapement syntax diagram, B-20 
Escapement type, B~20 
ESF$_AGGREGATE_TYPE aggregate item, 7-1 
ESF$_DAT aggregate, 7~2 to 7-3 
ESF$_DAT_DATETIME item in, 7-2 
ESF$_DAT_TIME_DIFF item in, 7-3 
ESF$_DAT_TIME_DIFF_C item in, 7-3 
items in, 7-2 
ESF$_EDS aggregate, 7-4 to 7-19 
ESF$_EDS_EDIT_STRING_C item in, 7-5 
ESF$_EDS_MAJOR_VERSION item in, 7-4 
ESF$_EDS_MINOR_VERSION item in, 7-4 
ESF$_EXT_DIRECT_REFERENCE item in, 7-20 
items in, 7-4 
ESF$_EXT aggregate, 7-20 to 7-21 
ESF$_EXT_DATA_VALUE_DESCRIPTOR item in, 
7-20 
ESF$_EXT_ENCODING_C item in, 7-20 
ESF$_EXT_INDIRECT_REFERENCE item in, 
7-20 
items in, 7-20 
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ESF$_NVL 
items in, 7-22 
ESF$_NVL aggregate, 7~22 to 7-23 
ESF$_NVL_NAME item in, 7-22 
ESF$_NVL_VALUE item in, 7-23 
ESF$_NVL_VALUE_C item in, 7-22 
ESF$_RPT aggregate, 7-24 to 7-26 
ESF$_RPT_COUNT item in, 7-24 
ESF$_RPT_SEQ item in, 7-26 
ESF$_RPT_SEQ C item in, 7-24 
items in, 7-24 
ESF$_TXS aggregate, 7-27 
ESF$_TXS_TEXT_STRING item in, 7~27 
items in, 7-27 
ESF$_USER_CONTEXT aggregate item, 7-1 
ESF application private aggregate, 7-20 to 7-21 
data value descriptor item in, 7-20 
direct reference item in, 7-20 
encoding indicator item in, 7-20 
indirect-reference item in, 7-20 
items in, 7-20 
ESF date and time aggregate, 7-2 to 7-3 
date and time item in, 7-2 
items in, 7~2 
time difference item in, 7-3 
ESF edit strings 
alphabetic, 7-5 
am-pm, 7-5 
any case, 7-6 
any character, 7-6 
application private, 7-6 
binary digit, 7-6 
CURRENCY_LIT, 7-7 
day number, 7-7 . 
decimal digit, 7-8 
digit separator, 7-8 
digit separator literal, 7-9 
encoded minus, 7-9 
encoded plus, 7-9 
encoded sign, 7-10 
exponent, 7-10 
float currency, 7-6 
floating blank suppression, 7-10 
floating minus, 7-12 
floating plus, 7-15 
floating sign, 7-17 
float zero replace, 7-19 
fraction second, 7-11 
hexadecimal digit, 7—11 
hour 12, 7-11 
hour 24, 7-11 
julian digit, 7-11 
logical character, 7-11 
long text, 7-12 
lowercase, 7-12 
minute, 7-13 
missing separator, 7-14 
month name, 7-14 
month number, 7-14 
octal digit, 7-14 
radix point, 7-16 
radix-point literal, 7-17 
repeat, 7-17 
reverse, 7-17 
second, 7-17 
string literal, 7-18 
UPPERCASE, 7-18 
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ESF edit strings (Cont.) 
week day name, 7-18 
year, 7-19 
ESF generic aggregate items, 7—1 
ESF$_AGGREGATE_TYPE, 7-1 
ESF$_USER_CONTEXT, 7-1 
ESF named value aggregate, 7-22 to 7-23 
items in, 7-22 
value data item in, 7-22, 7-23 
value name item in, 7-22 
ESF named values 
specifying the name for, 7-22 
specifying the value data for, 7-22 
ESF syntax diagrams, E-1 to E~3 
$E tag, defined, 4-91 
Exponent construct 
See ExpressionList syntax diagram and CFE 
expressions, transcendental 
ExprChoice syntax diagram, D-3 
See also ExpressionList syntax diagram 
Expression aggregate, 6-53 to 6-54 
items in, 6-53 
list item in, 6-53 
major version item in, 6-53 
minor version item in, 6-53 
Expression enumeration, 1-2 
Expression list aggregate, 6-9 to 6-52 
expression item in, 6-52 
items in, 6-9 
ExpressionList syntax diagram, D-3 
Expressions 


See CFE expressions 
Expression syntax diagram, B-37, D-2 
Ext-day syntax diagram 
See ExpressionList syntax diagram 
EXTERNAL built-in primitive, defined, B-2 
External content, 1-15 
External file references 
DTIF back end, 2-4 
DTIF front end, 2-2 
External reference 
identifying data type of, 4-18 
identifying storage system of, 4-18 
in DDIF front end, 2-1 
in Text front end, 2-3 
processing, 8-126 
specifying description of the data type of, 4-18 
specifying label for, 4-18 
specifying treatment of, 4-20 
External reference aggregate, 4-18 to 4—20 
See also DDIF$_ERF aggregate 


See DTIF external reference aggregate 

control item in, 4—20 

items in, 4—18t 

reference data type item in, 4-18 

reference descriptor item in, 4-18 

reference label item in, 4-18 

storage item in, 4-18 
External reference computed content, 1-16 
ExternalReference syntax diagram, B-20, C-2 
ExternalReflndex syntax diagram, B-23, C-3 
External restricted content aggregate, 4-21 to 4-22 

See also DDIF$_EXT aggregate 

data value descriptor item in, 4-21 

direct reference item in, 4-21 

encoding indicator item in, 4-22 


External restricted content aggregate (Cont.) 
encoding length item in, 4-22 
indirect reference item in, 4-21 
items in, 4-21t 

Ext-hour syntax diagram 
See ExpressionList syntax diagram 

Ext-minute syntax diagram 
See ExpressionList syntax diagram 

Ext-month syntax diagram 
See ExpressionList syntax diagram 

Extract substring left construct 


See ExpressionList syntax diagram and CFE 
expressions, string 
Extract substring right construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
Ext-second syntax diagram 
See ExpressionList syntax diagram 
Ext-year syntax diagram 
See ExpressionList syntax diagram 


F 


Factorial construct 
See ExpressionList syntax diagram and CFE 
expressions, transcendental 
False construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
FAX image 
See Image data unit aggregate, compression 
parameters item in, compression type item in 
-f format qualifier 
for the dxvdoc command, 2-18 
for the vdoc command, 2-20 
Field in table construct 
See ExpressionList syntax diagram and CFE 
expressions, choose and lookup 
Field reference aggregate, 6-55 
field context item in, 6—55 
field path item in, 6-55 
items in, 6-55 
Field-reference construct 
See ExpressionList syntax diagram and CFE 
expressions, field reference 
File 
See also Text file 
closing, 8-6 
creating, 8-39 
opening, 8-130 
File tag 
accessing, F—-10 
creation of, F—1 
DDIF, F—1 
disposition by COPY command, F-4 
preserving, F-13 
requirement for, F—1 
use of, F—1 
Fill area set 
controlling the rendition of, 4-23 
specifying the composite path of, 4-24 
Fill area set content aggregate, 4-23 to 4-24 
See also DDIF$_FAS aggregate 
flags item in, 4-23 
items in, 4-23t 


Fill area set content aggregate (Cont.) 


set path item in, 4-24 

FillAreaSet syntax diagram, B-12 

FIND DEFINITION routine, 8-79 

FIND TRANSFORMATION routine, 8-83 

$FINSWD collating sequence, 5-49 

$FLOAT editstring-name, 5—49 

FLOATING-POINT built-in primitive, defined, B—1 

Floating-point construct 
See ExpressionList syntax diagram and CFE 

expressions, literals 

Floating-point data type, defined, 1—4 

Flush routine, 9-4 

FLUSH STREAM routine, 8-86 

FmtFlags syntax diagram, C-14 

FmtPrec syntax diagram, C—13 

$FN tag, defined, 4-30, 4-90, 4-91 

Font definition 
specifying for the defining segment, 4-25 
specifying name for, 4-25 
specifying private data for, 4-25 

Font definition aggregate, 4-25 
See also DDIF$_FTD aggregate 
identifier item in, 4-25 
items in, 4—25t 
number item in, 4-25 
private data item in, 4-25 

FontDein syntax diagram, B~21 

FontNumber syntax diagram, B-29 

Foreground 
See pattern definition; Pattern definition aggregate; 

Image component space 

Format information 
generic format attributes, 5-29 
guidelines for storing, 5-41 
inheritance of, 5-29 
specifying a format descriptor for, 5-40 
specifying a format type indicator for, 5-30 
specifying a language preference index in, 5-39 
specifying a numeric data type indicator for, 5-31 
specifying display width for, 5-39 
specifying format direction for, 5-40 
specifying window identifier for, 5-30 

Format information aggregate, 5-29 to 5-42 
date format indicator item in, 5-36 
descriptor item in, 5-40 
display width item in, 5-39 
format direction item in, 5-40 
items in, 5-29 
language preference index item in, 5-39 
numeric format indicator item in, 5~31 
specifying a date edit string index for, 5-38 
specifying a date ESF format for, 5-38 
specifying a date standard order for, 5-37 
specifying a numeric edit string index for, 5-34 
specifying a numeric ESF format for, 5-34 
specifying a text edit string index for, 5-36 
specifying a text ESF format for, 5-36 
specifying a text format type indicator for, 5-35 
specifying borders for, 5-40 
specifying digits of precision for, 5-34 
specifying flags for, 5-38 
specifying format alignment for, 5-40 
specifying rounded or truncated values for, 5-34 
specifying standard date types for, 5-37 
specifying standard numeric types for, 5-32 
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Format information aggregate (Cont.) 


specifying standard text types for, 5-35 
specifying the number of fractional digits of 
precision for, 5-34 
window identifier item in, 5-30 
Formatinfo syntax diagram, C-10 
/FORMAT qualifier 
for the VIEW command, 2-13 
Formats 
See Format information 
Format syntax diagram, B-21 
FormattingPrimitive syntax diagram, B-10 
FormatType syntax diagram, C-11 
Frame 
bounding box, 4-142 
controlling presentation of, 4-140 
fixed position, 4-147 
galley, 4-149 
inline position, 4-148 
margin, 4—150 
specifying a coordinate transformation for, 4-152 
specifying attributes of, 4-139 to 4-152 
specifying lower left corner x position of, 4-141 
specifying lower left corner y position of, 4-141 
specifying the clipping path of, 4-144 
specifying the horizontal offset of the base for, 
4-150 
specifying the horizontal positioning of, 4-149 
specifying the horizontal position of the lower left 
corner of, 4-151 
specifying the outline path of, 4-143 
specifying the vertical offset from the base for, 
4-150 
specifying the vertical offset of the origin of, 4-148 
specifying the vertical positioning of the lower edge 
of, 4—149 
specifying the x position of the origin of, 4-147 
specifying the y position of the origin of, 4-147 
specifying upper right corner x position of, 4-141 
specifying upper right corner y position of, 4-141 
FrameParameters syntax diagram, B-21 
FRM | 
See Frame 
Front end 
DDIF, 2-1 
ddif$read_format entry point, 11-10 to 11-14 
dtif$read_format entry point, 11-10 to 11-14 
entry point, 8-15 
text, 2-2 to 2-3 
$F tag, defined, 4-91 
FTD 
See Font definition; Font definition aggregate 
Function computed content, 4-96 
FunctionLink syntax diagram, B-23 
Functions 
See CFE expressions 
Future value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Future value of an annuity construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Future value of a single sum construct 


See ExpressionList syntax diagram and CFE 
expressions, financial 
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Fva syntax diagram 

See ExpressionList syntax diagram 
Fvpv syntax diagram 

See ExpressionList syntax diagram 
Fv syntax diagram 


See ExpressionList syntax diagram 


G 


Galley 
specifying attributes for, 4-133 
specifying bottom margin for, 4-27 
specifying left margin for, 4-26 
specifying right margin for, 4-27 
specifying top margin for, 4-26 
Galley attributes aggregate, 4-26 to 4-27 
See also DDIF$_GLA aggregate 
galley bottom margin item in, 4-27 
galley left margin item in, 4-26 
galley right margin item in, 4-27 
galley top margin item in, 4-26 
items in, 4—26t 
GalleyAttributes syntax diagram, B—41 
Galley-based layout, 4-102, 4-104 
GalleyFrameParams syntax diagram, B-22 
GalleyLabel syntax diagram, B-25 
GalleyVerticalPosition syntax diagram, B-22 
Generalized Time universal defined type, defined, B-2 
General text content, 4-32 
General text content aggregate, 4-32 


See also DDIF$_GTX aggregate 
text content item in, 4-32 
Generic aggregate items 
CFE$_AGGREGATE_TYPE, 6-1 
CFE$_USER_CONTEXT, 6-1 
DDIF$_AGGREGATE_TYPE, 4—1 
DDIF$_USER_CONTEXT, 4-1 
DTIF$_AGGREGATE_TYPE, 5-1 
DTIF$_USER_CONTEXT, 5-1 
ESF$_AGGREGATE_TYPE, 7-1 
ESF$_USER_CONTEXT, 7-1 
Generic layout 
specifying descriptions of page templates and rules 
for, 4-42 
specifying private data in, 4-42 
Generic layout aggregate, 4-42 
See also DDIF$_LG1 aggregate 
items in, 4—42t 
page descriptions item in, 4-42 
private data item in, 4-42 
GenericLayout syntax diagram, B-39 
GenMeasure syntax diagram, B-42 
GenSize syntax diagram, B-43 
Geq syntax diagram 
See ExpressionList syntax diagram 
Get-Aggregate entry point, 11-5 
GET AGGREGATE routine, 8-88 
GET ARRAY SIZE routine, 8-94 
GET DOCUMENT routine, 8-97 
GET EXTERNAL ENCODING routine, 8-100 
Get-Position entry point, 11-8 
Get-position routine, 9-8 
Get routine, 9-6, 9-7 
GET STREAM POSITION routine, 8-103 
GET TEXT POSITION routine, 8-106 


GLY 

See Galley; Galley attributes aggregate 
$GO tag, defined, 4-91 
Graphics 

controlling interior fill pattern for, 4-130 
Graphics discard option, 1-17 
GraphicsPrimitive syntax diagram, B-11 
Greater than construct 

See ExpressionList syntax diagram and CFE 

expressions, Boolean and relational 

Greater than or equal to construct 


See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
$GRP tag, defined, 4-91 
Gtr syntax diagram 
See ExpressionList syntax diagram 


H 


Hard directive, 4-34 
values for, 4-34t, 4-81t 

Hard directive aggregate, 4-34 
See also DDIF$_HRD aggregate 
hard directive item in, 4-35 

Hard value directive, 4-36 to 4—37 
specifying escapement constant for, 4-37 
specifying escapement ratio denominator for, 4-37 
specifying escapement ratio numerator for, 4-37 
specifying new variable value for, 4-37 
specifying type of, 4—37 
specifying variable to be reset by, 4-37 

Hard value directive aggregate, 4-36 to 4-37 


See also DDIF$_HRV aggregate 
directive choice item in, 4-37 
escapement constant indicator in, 4-37 
escapement ratio item in, 4-37 
items in, 4-36t 
reset value item in, 4-37 
reset variable item in, 4-37 

Hlookup construct 


See ExpressionList syntax diagram and CFE 
expressions, choose and lookup 
-h paper-height qualifier 
for the dxvdoc command, 2-19 
for the vdoc command, 2-21 


Identification constructs 
See ExpressionList syntax diagram and CFE 
expressions, identification 
Identifier construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
If-then-else construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Image 
specifying application-private lookup tables for, 
4-136 
specifying aspect ratio along the pixel path of, 
4-134 
specifying attributes for, 4-134 to 4-136 
specifying correlation between physical image data 
and spectral components of, 4-135 
specifying direction of scanline capture for, 4-134 


Image (Cont.) 
specifying line progression path aspect ratio for, 
4-134 
specifying private data for, 4~134 
specifying the contents of, 4-41 
specifying the direction of pixel capture path for, 
4-134 
specifying the physical format of the pixel grid of, 
4-135 
specifying the representation of intensity levels in, 
4-135 
specifying wavelength information for, 4—136 
ImageAttributes syntax diagram, B-16 
ImageCodingAttrs syntax diagram, B-15 
Image component space 
specifying attributes for, 4-137 to 4-138 
specifying number of bits used for each image in, 
4-138 
specifying number of data planes for pixel in, 
4-138 
specifying number of spectral components in, 
4-138 
specifying physical organization of, 4—137 
specifying significance of data planes in, 4—138 
Image content aggregate, 4—41 
image content item in, 4-41 
items in, 4-41t 
See also DDIF$_IMG aggregate, 4—41 
Image data 
containing parameters for compression of, 4—39 
indicating compression scheme for a plane of, 
4-39 
specifying actual values of, 4—40 
specifying distance between pixels in, 4-39 
specifying distance between scanlines in, 4-39 
specifying number of pixels per scanline in, 4-38 
specifying number of scanlines in, 4—39 
specifying offset to first bit of, 4-39 
specifying pixel order in, 4-40 
specifying private data in, 4-38 
specifying total number of bits per pixel in, 4—40 
Image data unit aggregate, 4-38 to 4-40 


See also DDIF$_IDU aggregate 

compression parameters item in, 4—39 

compression type item in, 4-39 

data offset item in, 4-39 

items in, 4-38t 

number of lines item in, 4-39 

pixel order item in, 4—40 

pixels per line item in, 4-38 

pixel stride item in, 4—39 

plane bits per pixel item in, 4-40 

plane data item in, 4—40 

private data item in, 4-38 

scanline stride item in, 4-39 
Image discard processing option, 1-17 
ImagePrimitive syntax diagram, B-15 
Image resolution, 4-41 

See Segment attributes aggregate, frame bounding 

box items 

ImgCmptSpcAttrs syntax diagram, B—17 
ImgLutData syntax diagram, B-17 
Index construct 

See ExpressionList syntax diagram and CFE 

expressions, choose and lookup 

Inherit attributes processing option, 1-14 
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Inherit attributes processing option (Cont.) 
initial values, 1-14 
segment binding attributes, 1-14 
segment initial values, 1-14 
Initial values, 1-9, 1-14 
Initial values, defined, 1-14 
InlineFrameParams syntax diagram, B-21 
Input formats, 2-1 to 2-3 
INSERT AGGREGATE routine, 8-108 
In-table syntax diagram 
See ExpressionList syntax diagram 
INTEGER built-in primitive, defined, B—1 
Integer construct 
See ExpressionList syntax diagram and CFE 
expressions, literals 
SINTEGER editstring-name, 5-49 
Integrate construct 
See ExpressionList syntax diagram and CFE 
expressions, series 
Interest construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Interest rate construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
/INTERFACE qualifier 
for the VIEW command, 2-14 
Internal rate of return construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Int syntax diagram 
See ExpressionList syntax diagram 
Irr syntax diagram 
See ExpressionList syntax diagram 
Isblank syntax diagram 
See ExpressionList syntax diagram 
isdate syntax diagram 
See ExpressionList syntax diagram 
Iserror syntax diagram 
See ExpressionList syntax diagram 
Isnot-avail syntax diagram 
See ExpressionList syntax diagram 
Isnot-calc syntax diagram 
See ExpressionList syntax diagram 
Isnull syntax diagram 
See ExpressionList syntax diagram 
Isnumber syntax diagram 
See ExpressionList syntax diagram 
Isref syntax diagram 


See ExpressionList syntax diagram 
Isstring syntax diagram 
See ExpressionList syntax diagram 
$l tag, defined, 4-90, 4-91 
Item 
array-valued, 8-94 
erasing, 8-76 
finding definition of, 8-79 
locating, 8-115 
writing the contents of, 8-160 
Item change list, 4-153 
Item change list, defined, 1-3 
Item data types, 1-1t 
$IX tag, defined, 4-30, 4-90 
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K 


Kerning 
definition of, 4-127 


L 


Label syntax diagram, B-25 
Label types syntax diagram, B-24 
LangPreflndex syntax diagram, C—11 
LangPreffable syntax diagram, C-3 
Languagelndex syntax diagram, B-24 
Language preference table aggregate, 5-46 to 5-50 
collating sequence item in, 5-49 
customized collating sequence item in, 5-49 
data type format item in, 5-48 
items in, 5-46 
preference table index in, 5-46 
presentation attributes item in, 5-47 
private preference data item in, 5-46 
Language preference tables 
specifying an index to, 5~39 
specifying collating sequence for, 5-49 
specifying customized collating sequence for, 5-49 
specifying data type format for, 5-48 
specifying presentation attributes for, 5-47 
specifying private data for, 5-46 
Languages 
specifying for processing, 4-14 
Languge preference tables 
specifying the index for, 5-46 
Latini-String defined type, defined, B—4 
Latin1-String syntax diagram, B-4 
Latin1 text content, 4—164 
Latin1 text content aggregate, 4-164 
See also DDIF$_TXT aggregate 
Layout, 4-102 
forcing new line, galley, or page through, 4—46 
galley-based, 4-102, 4-104 
path-based, 4—102, 4-105 
position-relative, 4-102, 4-109 
selecting new galley for, 4-46 
specifying amount of space after a segment in, 
4-48 
specifying amount of space before a segment in, 
4-48 
specifying indentation distance in, 4-47 
specifying in-segment break condition in, 4-47 
specifying leading space between lines in, 4-48 
specifying new left indent in, 4-47 
specifying new right indent in, 4—47 
specifying post-segment break condition in, 4-47 
specifying pre-segment break condition in, 4-46 
specifying tab stops in, 4-49 
text-position, 4-102, 4-111 
Layout attributes aggregate, 4-45 to 4-49 
See also DDIF$_LL1 aggregate 
galley selection item in, 4—46 
initial directive item in, 4-46 
initial indent indicator item in, 4-47 
in-segment break condition item in, 4-47 
items in, 4—45t 
leading ratio item in, 4—48 
left indent indicator item in, 4-47 
post-segment break condition item in, 4-47 
pre-segment break condition item in, 4-46 
right indent indicator item in, 4-47 


Layout attributes aggregate (Cont.) 
space-after indicator item in, 4-48 
space-before indicator item in, 4-48 
tab stops item in, 4-49 

LayoutAttributes syntax diagram, B-42 

Layout galley 
specifying bounding box information for, 4-29 
specifying content streams for, 4-30 
specifying flag parameters for, 4-30 
specifying outline path for content in, 4-30 
specifying reference label for, 4-29 
specifying text overflow galley type in, 4-31 

Layout galley aggregate, 4-28 to 4-31 
See also DDIF$_GLY aggregate 
bounding box items for, 4-29 
flags item in, 4-30 
galley label item in, 4-29 
galley outline item in, 4—30 
galley streams item in, 4-30 
galley successor item in, 4-31 
items in, 4—28t 

LayoutGalley syntax diagram, B-—40 

LayoutGalley type, B-40 

LayoutObjectType syntax diagram, B-37 

LayoutPrimitive syntax diagram, B-40 

LayoutPrimitive type, B—40 

$LBL tag, defined, 4—91 

LeaderStyle syntax diagram, B-8 

Least squares construct 
See ExpressionList syntax diagram and CFE 

expressions, series 

LEAVE SCOPE routine, 8-112 

Legend 


See Content 
Legend attributes, 4-99 
LegendUnits syntax diagram, B~—25 
Leq syntax diagram 
See ExpressionList syntax diagram 
Less than construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Less than or equal to construct 


See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
$LE tag, defined, 4-91 
Line 
specifying attributes for, 4-128 to 4-131 
specifying denominator of miter ratio of, 4-130 
specifying ending shape of, 4-129 
specifying ending size of, 4—130 
specifying mask pattern of, 4-129 
specifying numerator of miter ratio of, 4-130 
specifying pattern for, 4-128 
specifying pattern size of, 4-129 
specifying shape of joins of, 4—130 
specifying shape of the endings of, 4-130 
specifying width of, 4-128 
LineAttributes syntax diagram, B-12 
LineDefn syntax diagram, B-31 
LineEndNumber syntax diagram, B-14 
LineJoin syntax diagram, B—14 
Line-style definition 
specifying line-style pattern in, 4-52 
specifying private data for, 4-53 
specifying reference number for, 4-52 
Line-style definition aggregate, 4-52 to 4-53 


Line-style definition aggregate (Cont.) 
See also DDIF$_LSD aggregate 
items in, 4—52t 
line-style number item in, 4-52 
line-style pattern item in, 4-52 
line-style private data item in, 4-53 
LineStyleNumber syntax diagram, B-14 
Linking application images 
on ULTRIX, 8-2 
on VMS, 8-2 
Linking converter images 
on ULTRIX, 11-2 
on VMS, 11-2 
Linking viewer images 
on ULTRIX, 13-2 
on VMS, 13-2 
Lit-complex-float syntax diagram 
See ExpressionList syntax diagram 
Lit-date syntax diagram 
See ExpressionList syntax diagram 
Lit-false syntax diagram 
See ExpressionList syntax diagram 
Lit-float syntax diagram 
See ExpressionList syntax diagram 
Lit-integer syntax diagram 
See ExpressionList syntax diagram 
Lit-pi syntax diagram 
See ExpressionList syntax diagram 
Lit-scaled-integer syntax diagram 
See ExpressionList syntax diagram 
$LIT tag, defined, 4-91 
Lit-text syntax diagram 
See ExpressionList syntax diagram 
Lit-true syntax diagram 
See ExpressionList syntax diagram 
Lit-vtext syntax diagram 
See ExpressionList syntax diagram 
LOCATE ITEM routine, 8-115 
Log, base 10 construct 
See ExpressionList syntax diagram and CFE 
expressions, transcendental 
Log, base e construct 
See ExpressionList syntax diagram and CFE 
expressions, transcendental 
Logi0 syntax diagram 
See ExpressionList syntax diagram 
Logest construct 
See ExpressionList syntax diagram and CFE 
expressions, series 
Logical AND construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Logical NOT construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Logical OR construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Logn syntax diagram 
See ExpressionList syntax diagram 
Lookup table entry aggregate, 4-77 
See also DDIF$_RGB aggregate 
blue value item in, 4~77 
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Lookup table entry aggregate (Cont.) 

green value item in, 4-77 

index item in, 4-77 

items in, 4-77t 

red value item in, 4~—77 
Lsqr syntax diagram 

See ExpressionList syntax diagram 
Lss syntax diagram 

See ExpressionList syntax diagram 
$L tag, defined, 4-91 


Mailing CDA documents 


See Transferring CDA documents 
MarginFrameParams syntax diagram, B-22 
MarginHorizontalPosition syntax diagram, B-23 
Marker 

specifying attributes for, 4-132 

specifying pattern for, 4—132 

specifying size for, 4-132 

specifying symbol used as, 4-132 
MarkerAttributes syntax diagram, B-15 
MarkerNumber syntax diagram, B-15, B-29 
Matches construct 

See ExpressionList syntax diagram and CFE 

expressions, choose and lookup 
Maximum construct 
See ExpressionList syntax diagram and CFE 
expressions, statistical 
Max syntax diagram 

See ExpressionList syntax diagram 
$MCS collating sequence, 5—49 
Measurement 

See Segment attributes aggregate, units per 

measure item in; Legend 
Measurement enumeration, 1-3 
Measurement imported, 1-16 
MeasurementUnits syntax diagram, B—28 
Measure syntax diagram, B-26 
Messages 

CDA$_ facility, G-1 to G-6 
Minimum construct 

See ExpressionList syntax diagram and CFE 

expressions, statistical 
Min syntax diagram 

See ExpressionList syntax diagram 
Mirr syntax diagram 

See ExpressionList syntax diagram 
$MN tag, defined, 4-30, 4-90 
Modified internal rate of return construct 

See ExpressionList syntax diagram and CFE 

expressions, financial 
Modulo syntax diagram 

See ExpressionList syntax diagram 
Modulus construct 

See ExpressionList syntax diagram and CFE 

expressions, Boolean and relational 
$MONEY editstring-name, 5-49 
Month name construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time 
Multiplication construct 

See ExpressionList syntax diagram and CFE 

expressions, arithmetic 
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Multiply syntax diagram 
See ExpressionList syntax diagram 


N 


Name-daynum syntax diagram 

See ExpressionList syntax diagram 
Name-day syntax diagram 

See ExpressionList syntax diagram 
Named edit string aggregate, 5-51 

edit string definition item in, 5-51 

edit string name item in, 5-51 

items in, 5-51 
Named edit strings 

$DATE, 5-49 

$DATETIME, 5-49 

$FLOAT, 5-49 

$INTEGER, 5-49 

$MONEY, 5-49 

$PERCENT, 5-49 

$PHONE, 5-49 

specifying the definition of, 5-51 

specifying the name for, 5-51 

$TEXT, 5-49 

$TIME, 5-49 
NamedEditString syntax diagram, C-4 
Named number built-in operator, defined, B-3 
Named parameter aggregate, 6-56 

items in, 6-56 

name item in, 6-56 

value item in, 6-56 
NamedParameter syntax diagram, D—2 
Named range aggregate, 5-52 

items in, 5-52 

name range data item in, 5-52 
Named range construct 

See ExpressionList syntax diagram and CFE 

expressions, variables 

Named ranges, 5-56 

See also Ranges 
Named-range syntax diagram 

See ExpressionList syntax diagram 
NamedRange syntax diagram, C-18 
NamedValueList syntax diagram, B-29, C—15 
NamedValue syntax diagram, B-28 
NamedValueTag syntax diagram, B-35 
Name-monthnum syntax diagram 

See ExpressionList syntax diagram 
Name-month syntax diagram 

See ExpressionList syntax diagram 
Negate syntax diagram 


See ExpressionList syntax diagram 
Negation construct 
See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
Neq syntax diagram 
See ExpressionList syntax diagram 
Net present value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
NEXT AGGREGATE routine, 8-120 
$NORWEG collating sequence, 5-49 


Not available construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Not-avail syntax diagram 
See ExpressionList syntax diagram 
Not-calc syntax diagram 


See ExpressionList syntax diagram 
Not calculable construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Not equal to construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
Not syntax diagram 
See ExpressionList syntax diagram 
Now construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time literals 
AINOJOUTPUT qualifier 
for the VIEW command, 2-14 
/INOJOVERRIDE_FORMAT qualifier 
for the VIEW command, 2-14 
/[NOJPAGE qualifier 
for the VIEW command, 2-14 
Npv syntax diagram 
See ExpressionList syntax diagram 
NULL built-in primitive, defined, B—1 
Null construct 
See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Number of periods given present value construct 


See ExpressionList syntax diagram and CFE 
expressions, financial 
Number of periods to achieve future value construct 


See ExpressionList syntax diagram and CFE 
expressions, financial 
NumericFmt syntax diagram, C—12 


O 


ObjectDescriptor defined type, defined, B-4 
ObjectDescriptor syntax diagram, B-4 
Object identifier, defined, 1-3 
OBJECT IDENTIFIER built-in primitive, defined, B-2 
OBJECT ID TO AGGREGATE TYPE routine, 8-123 
Occurrence definition 

specifying permitted types of, 4-57 

specifying structure definition in, 4-58 
Occurrence definition aggregate, 4-57 to 4-58 

See also DDIF$_OCC aggregate 

items in, 4—57t 

occurrence indicator item in, 4-57 

structure element indicator item in, 4-58 
OccurrenceDefn syntax diagram, B-34 
OCTET STRING built-in primitive, defined, B—1 
One’s complement construct - 


See ExpressionList syntax diagram and CFE 
expressions, binary 
Ones-cmp syntax diagram 
See ExpressionList syntax diagram 
-O options qualifier 
for the cdoc command, 2-17 
for the dxvdoc command, 2-19 
for the vdoc command, 2-21 
OPEN CONVERTER routine, 8-126 


OPEN FILE routine, 8-130 
OPEN STREAM routine, 8-138 
OPEN TEXT FILE routine, 8-141 
OPTIONAL built-in operator, defined, B-3 
/OPTIONS qualifier . 
for the CONVERT/DOCUMENT command, 2-11 
for the VIEW command, 2-14 
Or syntax diagram 
See ExpressionList syntax diagram 
Output formats, 2-3 to 2-9 


p 


PageDesclabel syntax diagram, B-25 
Page description 
including private data in, 4-59 
specifying reference label for, 4-59 
specifying the type of, 4-60 
Page description aggregate, 4-59 to 4-60 
See also DDIF$_PGD aggregate 
indicator item in, 4-60 
items in, 4—59t 
label item in, 4-59 
private data item in, 4~—59 
Page descriptions language discard option, 1-17 
PageDescription syntax diagram, B-39 
Page layout 
specifying frame for, 4—63 
specifying nominal measure for, 4-62 
specifying orientation of, 4-63 
specifying prototype for, 4-63 
specifying reference label for, 4—62 
specifying x shrink amount for, 4-62 
specifying x stretch amount for, 4-62 
specifying y nominal measurement for, 4-62 
specifying y shrink amount for, 4-63 
specifying y stretch amount for, 4-62 
Page layout aggregate, 4-61 to 4-63 
See also DDIF$_PGL aggregate 
content item in, 4-63 
items in, 4-61t 
layout identifier item in, 4-62 
nominal measure indicator item in, 4-62 
orientation item in, 4-63 
prototype item in, 4-63 
x shrink indicator item in, 4-62 
x stretch indicator item in, 4-62 
y shrink indicator item in, 4-63 
y stretch indicator item in, 4-62 
PageLayoutLabel syntax diagram, B-25 
PageLayout syntax diagram, B—40 
Page selection 
specifying page-side criteria for, 4-64 
specifying selected layout for, 4-65 
Page selection aggregate, 4-64 to 4-65 
See also DDIF$_PGS aggregate 
items in, 4—64t 
page-side criteria item in, 4-64 
select page layout indicator item in, 4-65 
PageSet syntax diagram, B-39 
Parenthesized construct 
See ExpressionList syntax diagram and CFE 
expressions, miscellaneous 
Parenthesized expression aggregate, 6-57 
expression item in, 6-57 
items in, 6-57 
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Parenthesized expression aggregate (Cont.) 
text string item in, 6-57 
Path-based layout, 4-102, 4—105 
Path definition 
specifying composite path in, 4-66 
specifying private data for, 4-66 
specifying reference number for, 4-66 
Path definition aggregate, 4-66 
See also DDIF$_PHD aggregate 
description item in, 4-66 
items in, 4—66t 
number item in, 4—66 
private data item in, 4-66 
PathDefn syntax diagram, B-30 
PathNumber syntax diagram, B-29 
Pattern definition © 
selecting as either solid color or standard pattern, 
4-68 
selecting color type for, 4-68 
specifying blue intensity for, 4-68 
specifying color map for, 4-69 
specifying green intensity for, 4-68 
‘specifying image data unit for, 4-69 
specifying private data for, 4-69 
specifying red intensity for, 4-68 
specifying reference number for, 4-67 
specifying standard pattern number for, 4-68 
Pattern definition aggregate, 4-67 to 4-69 


See also DDIF$_PTD aggregate 
blue intensity item in, 4-68 
colors item in, 4-69 
definition indicator item in, 4-68 
green intensity item in, 4-68 
items in, 4—67t 
number item in, 4-67 
private data item in, 4-69 
raster-paitern item in, 4-69 
red intensity item in, 4-68 
solid color indicator item in, 4-68 
standard pattern number item in, 4-68 
PatternDefn syntax diagram, B-32 
PatternNumber syntax diagram, B-30 
Payback construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Payment per period given present value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Payment per period to achieve future value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
$PDL tag, defined, 4-90 
Percent construct 
See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
$PERCENT editstring-name, 5-49 
Perfv syntax diagram 
See ExpressionList syntax diagram 
Periods to achieve future value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Perpmt syntax diagram 


See ExpressionList syntax diagram 
Perpv syntax diagram 


See ExpressionList syntax diagram 
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$PHONE editstring-name, 5-49 
PI construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Plus-days syntax diagram 
See ExpressionList syntax diagram 
Plus-hours syntax diagram 
See ExpressionList syntax diagram 
Plus-mins syntax diagram 
See ExpressionList syntax diagram 
Plus-months syntax diagram 
See ExpressionList syntax diagram 
Plus-secs syntax diagram 
See ExpressionList syntax diagram 
Plus-weeks syntax diagram 
See ExpressionList syntax diagram 
Plus-years syntax diagram 
See ExpressionList syntax diagram 
Pmifv syntax diagram 
See ExpressionList syntax diagram 
Pmtpv syntax diagram 
See ExpressionList syntax diagram 
Polarity 
See Segment attributes aggregate, brightness 
polarity item in 
Polyline 
controlling the drawing of line segments of, 4-44 
controlling the rendition of, 4-43 
specifying the layout of, 4-44 
Polyline content aggregate, 4-43 to 4-44 
See also DDIF$_LIN aggregate 
draw pattern item in, 4—44 
flags item in, 4-43 
items in, 4—43t 
line path indicator item, 4-44 
PolyLinePath syntax diagram, B-31 
Polyline syntax diagram, B-11 
Position-relativelayout, 4-102, 4—109 
Position syntax diagram, B-26 
PostScript back end, 2-5 to 2-8 
conversion restrictions, 2—5 
data mapping in, 2-5 
processing options in, 2-6 
Power syntax diagram 
See ExpressionList syntax diagram 
-p qualifier 
for the vdoc command, 2-21 
Present value of an annuity construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Present value to achieve future value construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Primary aggregates, defined, 1-5 
Principal construct 
See ExpressionList syntax diagram and CFE 
expressions, financial 
Private collating sequence, 5-49 
Private content aggregate, 4-74 to 4~75 
See also DDIF$_PVT aggregate 
external reference index item in, 4-75 
items in, 4—-74t 
value indicator item in, 4-75 
value name item in, 4-75 


Private data, 4-74 
See CFE application private aggregate 
See DTIF application private aggregate 
See ESF application private aggregate 
PrivateFuncExpr syntax diagram, D—1 
Private-function construct 
See ExpressionList syntax diagram and CFE 
expressions, private 
Processing options 
attribute inheritance, 1-14 
style guides, 1-15 
type definitions, 1-14 
type references, 1-14 
discard segments, 1~17 
evaluate content, 1-15 
computed content, 1-16 
content definitions, 1-16 
content references, 1-16 
for DDIF, 1-13, 8-47, 8-134 
in PostScript back end, 2-6 
in Text back end, 2-4 
retain definitions, 1-15 
PRUNE AGGREGATE routine, 8-145 
PRUNE POSITION routine, 8-148 
$P tag, defined, 4-91 
PUT AGGREGATE routine, 8-150 
PUT DOCUMENT routine, 8-153 
Put routine, 9-10 
Pva syntax diagram 
See ExpressionList syntax diagram 
Pvfv syntax diagram 
See ExpressionList syntax diagram 


R 


Raise to a power construct 


See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
Random number construct 
See ExpressionList syntax diagram and CFE 
expressions, random number 
Random-u syntax diagram 
See ExpressionList syntax diagram 
Range definition aggregate, 5-55 to 5-56 
items in, 5-55 
range name item in, 5-55 
range region item in, 5-56 
range type item in, 5-55 
sort key item in, 5-56 
RangeDefn syntax diagram, C—17 
Ranges 
cell ranges, 5-18 
column ranges, 5-19 
contiguous, 5-55 
disjoint, 5-55 
named ranges, 5-52 
row ranges, 5-59 
specifying a name for, 5-55 
specifying a range region in, 5—56 
specifying a sort key for, 5-56 
specifying the type of, 5-55 
specifying within a table window, 5-67 
specifying within table metadata, 5-64 
Range syntax diagram, C—17 


Rate syntax diagram 
See ExpressionList syntax diagram 
Ratio syntax diagram, B-26 
READ TEXT FILE routine, 8—156 
Receiving CDA documents 
on an ULTRIX system, 3-3 
ona VMS system, 3-2 
Record definition 
specifying segments creating instances of, 4-76 
specifying type identifier of, 4—76 
specifying variables of, 4~—76 
Record definition aggregate, 4-76 
See also DDIF$_RCD aggregate 
contents item in, 4-76 
items in, 4—76t 
tag item in, 4-76 
type item in, 4-76 
RecordDefn syntax diagram, B-39 
RecordList syntax diagram, B-38 
Reference 
processing external, 8-126 
Reference syntax diagram, B-32 
REMOVE AGGREGATE routine, 8-158 
RenditionCode syntax diagram, B-8 
Repeat aggregate, 7-24 to 7-26 
items in, 7-24 
repeat count item in, 7-24 
single edit string indicator item in, 7-24 
single edit string item in, 7-26 
Repeat syntax diagram, E-3 
Resolution 
See Segment attributes aggregate, frame bounding 
box items 
Resolution of images, 4-41 
Restricted content 
external, 4-21 to 4-22 
describing data value of, 4-21 
identifying data type of, 4-21 
indicating encoding of, 4-22 
specifying encoding length of, 4-22 
private 
identifying value of, 4-75 
indicating type of data in, 4—75 
specifying external reference index for, 4-75 
RestrictedContent syntax diagram, B-18 
Reverse image 


See Segment attributes aggregate, brightness 
polarity item in 
RGB syntax diagram, B-19 
RightAngle syntax diagram, B-26 
Root aggregate, 4-12 
See DTIF document root aggregate 
creating, 8-45 
deleting, 8-60 
document content item in, 4-12 
document descriptor item in, 4-12 
document header item in, 4-12 
items in, 4-12t 
Root segment, 4-78 
Rotation 
See Transformation; Transformation aggregate; 
Path definition 
Round syntax diagram 
See ExpressionList syntax diagram 
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Round to the nearest whole number construct 

See ExpressionList syntax diagram and CFE 
expressions, conversion 

Routines 
Allocate/Deallocates, 9-2 
cda$aggregate_type_to_object_id, 8-3 
cda$close_file, 8-6 
cda$close_stream, 8-9 
cda$close_text_file, 8-11 
cda$convert, 8-13 
cda$convert_aggregate, 8-24 
cda$convert_document, 8-28 
cda$convert_position, 8-31 
cda$copy_aggregate, 8-33 
cda$create_aggregate, 8-36 
cda$create_file, 8-39 
cda$create_root_aggregate, 8-45 
cdafcreate_stream, 8-50 
cdag$create_text_file, 8-54 
cda$delete_aggregate, 8-58 
cda$delete_root_aggregate, 8-60 
cda$enter_scope, 8-62 
cda$erase_item, 8-76 
cda$find_definition, 8-79 
cda$find_transformation, 8-83 
cda$flush_stream, 8-86 
cda$get_aggregate, 8-88 
cda$get_array_size, 8-94 
cda$get_document, 8-97 
cda$get_external_encoding, 8-100 
cda$get_siream_position, 8-103 
cda$get_text_position, 8-106 
cda$insert_aggregate, 8-108 
cda$leave_scope, 8-112 
cda$locate_item, 8-115 
cda$next_aggregate, 8-120 
cda$object_id_to_aggregate_type, 8-123 
cda$open_converter, 8-126 
cda$open_file, 8-130 
cda$open_stream, 8-138 
cda$open_text_file, 8-141 
cda$prune_aggregate, 8-145 
cda$prune_position, 8-148 
cda$put_aggregate, 8-150 
cda$put_document, 8-153 
cda$read_text_file, 8-156 
cda$remove_aggregate, 8-158 
cda$store_item, 8—160 
cda$write_text_file, 8-168 
close entry point, 11-3 
domain$read_format, 11-10 
domain$write_format entry point, 11-15 
Flush, 9-4 
Get, 9-6, 9-7 
Get-Aggregate entry point, 11-5 
Get-position, 9-8 
Get_position, 11-8 
Put routine, 9-10 

RowDefn syntax diagram, C-6 

Row number construct 
See ExpressionList syntax diagram and CFE 

expressions, variables 
Row-num syntax diagram 


See ExpressionList syntax diagram 
RowNum syntax diagram, C-16 
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Row portion of cell name construct 


See ExpressionList syntax diagram and CFE 
expressions, cell-related 
Row range aggregate 


See CFE row range aggregate 


See DTIF row range aggregate 
Row range construct 

See ExpressionList syntax diagram and CFE 

expressions, variables 

Row-range syntax diagram 

See ExpressionList syntax diagram 
RowRange syntax diagram, C—18 
Rows 

See Table rows 
-t qualifier 

for the dxvdoc command, 2-19 

for the vdoc command, 2-21 


S 


Scaled integer construct 
See ExpressionList syntax diagram and CFE 
expressions, literals 
Scaling 
See Transformation; Transformation aggregate; 
Legend attributes 
Secondary aggregates, defined, 1-5 
Segment 
binding attributes to, 4-79 
identifying changed attributes in, 4-153 
indicating category of the content of, 4-90 
listing the variables bound to, 4—91 
referencing a type definition for, 4-79 
root, 4-78 
specifying a reference label for, 4-78 
specifying available content definitions for, 4-116 
specifying available font definitions for, 4-112 
specifying available line style definitions for, 4—115 
specifying available path definitions for, 4-114 
specifying available pattern definitions for, 4-113 
specifying available type definitions for, 4-117 
specifying content of, 4-80 
specifying content streams for, 4-90 
specifying generic layout for, 4-79 
specifying language for, 4—98 
specifying name for, 4-79 
specifying private attributes for, 4-90 - 
specifying processing characteristics for, 4-91 
specifying specific layout for, 4-79 
specifying the type of computed content in, 4-92 
Segment attributes 
units per measurement, 1-16 
Segment attributes aggregate, 4-85 to 4-153 
See also DDIF$_SGA aggregate 
alternate presentation item in, 4-101 
bits per component item in, 4-138 
brightness polarity item in, 4-135 
component space organization item in, 4-137 
component wavelength indicator item in, 4-136 
computed content indicator item in, 4-92 
content category item in, 4-90 
content definition item in, 4-116 | 
content streams item in, 4-90 
cross-reference index item in, 4-95 
cross-reference segment label item in, 4-95 


Segment attributes aggregate (Cont.) 


cross-reference variable label item in, 4-95 

data plane significance item in, 4-138 

data-planes-per-pixel item in, 4-138 

fixed frame position items in, 4—147 

font definition item in, 4-112 

frame bounding box items, 4-141 to 4-142 

frame clipping path item in, 4-144 

frame content transformation item in, 4-152 

frame flags item in, 4-140 

frame outline item in, 4-143 

frame position item in, 4-146 

function name item in, 4-96 

function parameters item in, 4-96 

galley frame items in, 4-149 

galley layout item in, 4-104 

grid type item in, 4-135 

horizontal alignment item in, 4-107 

inline frame items in, 4-148 

item change list item in, 4—153 

items in, 4—86t 

language item in, 4-98 

layout format item in, 4—106 

layout indicator item, 4-103 

layout path item in, 4—105 

legend unit denominator item in, 4-99 

legend unit name item in, 4-99 

legend unit numerator item in, 4—99 

line end finish item in, 4-130 

line end size indicator item in, 4-130 

line end start item in, 4-129 

line interior pattern item in, 4-130 

line joint item in, 4-130 

line mask pattern item in, 4-129 

line pattern size item in, 4-129 

line progression item in, 4-134 

line progression path aspect ratio item in, 4-134 

line style definition item in, 4-115 

line style item in, 4-128 

line width indicator item in, 4-128 

lookup table item in, 4-136 

margin frame items in, 4-150 to 4-151 

marker mask pattern item in, 4-132 

marker size indicator item in, 4-132 

marker style item in, 4-132 

miter limit denominator item in, 4-130 

miter limit numerator item in, 4-130 

number of components item in, 4-138 

path definition item in, 4-114 

path orientation indicator item, 4-106 

pattern definition item in, 4-113 

pixel path aspect ratio item in, 4-134 

pixel path item in, 4-134 

private attributes item in, 4~90 

private data item in, 4-134 

reference index item in, 4-93 

reference target item in, 4-93 

relative horizontal character position item in, 4-109 
_ relative vertical character position item in, 4-109 

segment binding item in, 4-91 

segment tags item in, 4-91 

spectral component mapping item in, 4-135 

structure attributes items in, 4-97 

text character decimal alignment item in, 4-125 

text direction item in, 4-124 

text font item in, 4~120 

text kerning item in, 4-127 


Segment attributes aggregate (Cont.) 


text leader attribute items in, 4-126 
text mask pattern item in, 4-119 
text position indicator item in, 4-111 
text rendition item in, 4-122 
text size attribute items in, 4—123 
type definition item in, 4-117 
unit name item in, 4-100 
units per measurement item in, 4-100 
variable item in, 4-94 
vertical alignment item in, 4-108 
wrap attributes item in, 4-104 
SegmentAitributes syntax diagram, B-33 
Segment binding 
specifying computed variable items in, 4-158 
specifying counter variable items for, 4-156 to 
4-157 
specifying list variable items in, 4—159 
specifying name of variable being defined in, 
4-154 
specifying type of variable value in, 4—155 
Segment binding aggregate, 4-154 to 4-159 
See also DDIF$_SGB aggregate 
computed variable items in, 4-158 
counter variable items in, 4-156 to 4-157 
items in, 4-154t 
list variable items in, 4-159 
variable name item in, 4-154 
variable value indicator item in, 4-155 
Segment binding attributes, 1-14 
Segment definitions, 1-15 
Segment initial values, 1-14 
SegmentLabel syntax diagram, B~24 
SegmentPrimitive syntax diagram, B—7 
Segment processing, 1-15 
SegmeniTag syntax diagram, B-35 
SegTypeDefn syntax diagram, B-33 
Selector list aggregate, 6-61 
criteria item in, 6-61 
items in, 6-61 
selection item in, 6-61 
Sending CDA documents 
on an ULTRIX system, 3-2 
on a VMS system, 3-1 
Sequence 
removing an aggregate from, 8-158 
SEQUENCE built-in constructor, defined, B-2 
SEQUENCE OF built-in constructor, defined, B-2 
-$ format qualifier 
for the cdoc command, 2-16 
SGA 
See Segment attributes aggregate 
Sigma construct 
See ExpressionList syntax diagram and CFE 
expressions, series 
Sign construct 
See ExpressionList syntax diagram and CFE 
expressions, sign 
Sine construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Single syntax diagram, E-2 
Sin syntax diagram 
See ExpressionList syntax diagram 
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Size 
See Measurement enumeration; Transformation; 
Transformation aggregate; Legend attributes 
Size syntax diagram, B-26 
Soft directive, 4-81 
values for, 4-34t, 4-81t 
Soft directive aggregate, 4—81 


DDIF$_SFT aggregate 
soft directive item in, 4-82 
Soft value directive, 4-83 to 4-84 
specifying escapement constant for, 4-84 
specifying escapement ratio denominator for, 4-84 
specifying escapement ratio numerator for, 4-84 
specifying new variable value for, 4-84 
specifying type of, 4-84 
specifying variable to be reset by, 4-84 
Soft value directive aggregate, 4-83 to 4-84 
See also DDIF$_SFV aggregate 
directive choice item in, 4-84 
escapement constant indicator in, 4-84 
escapement ratio item in, 4-84 
items in, 4—-83t 
reset value item in, 4-84 
reset variable item in, 4-84 
Sort ranges, 5-56 
See also Ranges 
$SPANSH collating sequence, 5-49 
Specific layout 
‘ specifying type of layout for, 4-50 
Specific layout aggregate, 4-50 to 4-51 
See also DDIF$_LS1 aggregate 
items in, 4—50t 
-fayout indicator item in, 4-50 
SpecificLayout syntax diagram, B-41 
Sart syntax diagram 


See ExpressionList syntax diagram 
Square root construct 
See ExpressionList syntax diagram and CFE 
expressions, Boolean and relational 
$S tag, defined, 4-91 
Standard deviation construct 
See ExpressionList syntax diagram and CFE 
expressions, statistical 
StandardPattern syntax diagram, B-32 
Starts syntax diagram 
See ExpressionList syntax diagram 
Stdev syntax diagram 
See ExpressionList syntax diagram 
StorageSystemTag syntax diagram, B-36, C-3, D-2 
Stored semantics file attribute, F—1 
See also File tag 
STORE ITEM routine, 8-160 _ 
Storing format information, 5-41 
Str-char syntax diagram 
See ExpressionList syntax diagram 
Str-code syntax diagram 
See ExpressionList syntax diagram 
Str-concat syntax diagram 
See ExpressionList syntax diagram 
Stream 
closing, 8-6, 8-9 
creating, 8-39, 8-50, 8-130 
flushing contents of, 8-86 
opening, 8-138 
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Stream (Cont.) 
retrieving position.in, 8-103 
retrieving size of, 8-103 
returning position in, 8-31 
returning size of, 8-31 
writing a document to, 8-153 
writing aggregates to, 8-150 
StreamTag syntax diagram, B-36 
Str-extract syntax diagram 
See ExpressionList syntax diagram 
Str-find syntax diagram 
See ExpressionList syntax diagram 
Str-fixed syntax diagram 
See ExpressionList syntax diagram 
Str-format syntax diagram 
See ExpressionList syntax diagram 
String character code construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String character construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String concatenate construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
StringExpression syntax diagram, B-38 
String extract construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String find substring construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String fixed construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String format aggregate, 6-62 
edit string item in, 6-62 
items in, 6-62 
value item in, 6-62 
String format construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
StringLayout syntax diagram, B-9 
String length construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String lowercase construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String pretty aggregate, 6-63 
flags item in, 6-63 
items in, 6-63 
string item in, 6-63 
String pretty construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String proper construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String repeat construct 
See ExpressionList syntax diagram and CFE 
expressions, string 


String replace construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String reverse construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String starts with construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String trim construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
String uppercase construct 
See ExpressionList syntax diagram and CFE 
expressions, string 
Str-left syntax diagram 
See ExpressionList syntax diagram 
Str-length syntax diagram 
See ExpressionList syntax diagram 
Str-lower syntax diagram 
See ExpressionList syntax diagram 
Str-pretty syntax diagram 
See ExpressionList syntax diagram 
Str-proper syntax diagram 


See ExpressionList syntax diagram 
Str-repeat syntax diagram 


See ExpressionList syntax diagram 
Str-replace syntax diagram 

See ExpressionList syntax diagram 
Str-reverse syntax diagram 

See ExpressionList syntax diagram 
Str-right syntax diagram 

See ExpressionList syntax diagram 
Str-trim syntax diagram 

See ExpressionList syntax diagram 
Structure attributes 

specifying legal types of, 4-97 
StructureDefinition syntax diagram, B-34 
StructureElement syntax diagram, B-34 
Str-upper syntax diagram 

See ExpressionList syntax diagram 
Style guides, 1-15 
Subtraction construct 

See ExpressionList syntax diagram and CFE 

expressions, arithmetic 

Subtract syntax diagram 


See ExpressionList syntax diagram 
Summation construct 

See ExpressionList syntax diagram and CFE 

expressions, statistical 

Sum syntax diagram 

See ExpressionList syntax diagram 
Symbols 

specifying within table metadata, 5-64 
Syntax diagrams 

Angle, B—25 

AngleRef, B—25 

App!Private, B-5, C-14, E-3 

Arc, B-12 

ArcPath, B-30 

ArrayDefn, C-8 

ASCIIString, B-25, C—15 

BeginSegment, B—7 


Syntax diagrams (Cont.) 


Binding, B-36 
BoundingBox, B-18 
BreakCriteria, B—42 
CategoryTag, B-35 
CellCoord, C—16 

CellData, C-6 

CellRange, C-18 
CeliValue, C-—7 
Character-String, B-5 
ColAttributes, C-9 
ColNum, C-16 

Color, B-19 

ColRange, C-18 
ComplexFloat, C-8 
CompositePath, B-30 
ComputeDefn, B-19 
Conformancetag, B-35 
ContentDefn, B-24 
ContentReference, B-18 
ContentReferencePrimitive, B-18 
CounterDefn, B-37 
CounterStyle, B-38 
CrossRef, B-20 
CubicBezier, B-12 
CubicBezierPath, B-31 
Datatype, C-—10 

DateFmt, C-13 

DateTime, C—14 
DDIFDocument, B-5 
DecimalString, D-9 
Directive, B-10 
DocumentDescriptor, B~5, C—1 
DocumentHeader, B-6, C—2 
Document root segment, B-6 
DTiFDocument, C-1 
EditStrBuff, E-1 
EditStrindex, C-12 
EditString, D~9, E—1 
Escapement, B-20 
EscapementDirective, B-11 
Expression, B-37, D-2 
ExpressionList, D-3 
ExternalReference, B~20, C~2 
ExternalRefindex, B-23, C—3 
FieldRef, D-9 

FillAreaSet, B-12 
FmtFlags, C~14 

FmtPrec, C-13 

FontDefn, B-21 
FontNumber, B-29 

Format, B-21 

Formatinfo, C-—10 
FormattingPrimitive, B-10 
FormatType, C—11 
FrameParameters, B-21 
FunctionLink, B-23 
GalleyAttributes, B—41 
GalleyFrameParams, B—22 
GalleyVerticalPosition, B~22 
GenericLayout, B-39 
GenMeasure, B-42 
GenSize, B-43 
GraphicsPrimitive, B-11 
ImageAttributes, B-16 
ImageCodingAttrs, B-15 
ImagePrimitive, B-15 
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Syntax diagrams (Cont.) 


ImgCmptSpcAttrs, B-17 
ImgLutData, B—17 
InlineFrameParams, B-21 
Label, B—25 

Label types, B-24 
LangPreflndex, C—11 
LangPrefTable, C-3 
Languagelndex, B-24 
Latin1-String, B-4 
LayoutAttributes, B-42 
LayoutGalley, B—40 
LayoutObjectType, B-37 
LayoutPrimitive, B-40 
LeaderStyle, B-8 
LegendUnits, B-25 
LineAttributes, B-12 
LineDefn, B-31 
LineEndNumber, B-14 
LineJoin, B-14 
LineStyleNumber, B-14 
MarginFrameParams, B-22 
MarginHorizontalPosition, B—-23 
MarkerAttributes, B-15 
MarkerNumber, B-15, B—-29 
Measure, B-26 
MeasurementUnits, B-28 
NamedEditString, C—4 
NamedParameter, D-2 
NamedRange, C-18 
NamedValue, B~28 
NamedValueList, B-29, C-15 
NamedValueTag, B-35 
NumericFmt, C-—12 
ObjectDescriptor, B-4 
OccurrenceDefn, B-34 
PageDescription, B-39 
PageLayout, B-40 __ 
PageSet, B-39 
ParenthesizedExpr, D-9 
PathDefn, B-30 
PathNumber, B-29 
PatternDefn, B-32 
PatternNumber, B-30 
Polyline, B—11 
PolyLinePath, B-31 
Position, B-26 
PrivateFuncExpr, D-1 
Range, C-—17 
RangeDefn, C—17 

Ratio, B-26 
RecordDefn, B-39 
RecordList, B-38 
Reference, B-32 
RenditionCode, B-8 
Repeat, E-3 
RestrictedContent, B-18 
RGB, B-19 

RightAngle, B-26 
RowDefn, C-6 
RowNum, C-16 
RowRange, C-—18 
SegmentAttributes, B-33 
SegmentPrimitive, B—7 
SegmentTag, B-35 
SegTypeDefn, B-33 
SelectorList, D-8 
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Syntax diagrams (Cont.) 
Single, E-2 
Size, B-26 
SpecificLayout, B—41 
StandardPattern, B-32 
StorageSystemTag, B-36, C-3, D-2 
StreamTag, B-36 
StringExpression, B-38 
StringLayout, B-9 
StructureDefinition, B-34 
StructureElement, B-34 
TableDefn, C—4 
TableMD, C-5 
TabStop, B-43 
TabStopList, B-43 
Tag, B-35 
Text, D-8 
TextAttributes, B-7 
TextFmt, C—13 
TextLayout, B~9 
TextPrimitive, B-7 
Text-String, B-5 
Transformation, B-36 
ValueData, B-28, C-15 
ValueDirective, B-10 
VariableLabel, B-25 
VariableReset, B-11 
VaryingText, C—7, D-8 
WindowDefn, C-5 
WrapAttributes, B—41 
XCoordinate, B-27 
YCoordinate, B-28 


T 


Table construct 
See ExpressionList syntax diagram and CFE 
expressions, choose and lookup 
Table definition 
specifying descriptive information for, 5-61 
specifying number of columns for, 5-60 
specifying number of rows for, 5-61 
specifying private data for, 5-61 
specifying the rows in, 5-61 
specifying windows for, 5-61 
Table definition aggregate, 5-60 to 5-61 
descriptive table information item in, 5-61 
items in, 5-60 
number of columns item in, 5-60 
number of rows item in, 5-61 
private table data item in, 5-61 
rows item in, 5-61 
window item in, 5-61 
TableDefn syntax diagram, C—4 
Table discard option, 1-17 
TableMd syntax diagram, C-5 
Table metadata 
specifying a table identifier for, 5-62 
specifying a table name for, 5-62 
specifying column attributes for, 5-63 
specifying flags for, 5-63 
specifying formats for, 5-63 
specifying private data for, 5-62 
specifying ranges for, 5-64 
specifying symbols for, 5-64 
specifying table descriptor for, 5-62 
Table metadata aggregate, 5-62 to 5-64 


Table metadata aggregate (Cont.) 
column attributes item in, 5~-63 
flags item in, 5-63 
format item in, 5-63 
items in, 5-62 
private table data item in, 5-62 
ranges item in, 5-64 
symbols item in, 5-64 
table descriptor item in, 5-62 
table identifier item in, 5—62 
table name item in, 5-62 
Table row aggregate, 5-57 to 5-58 
cell item in, 5-58 
flags item in, 5-58 
format item in, 5-57 
identifier item in, 5-57 
items in, 5-57 
private row data item in, 5-57 
Table rows 
specifying an identifier for, 5-57 
specifying cells for, 5-58 
specifying flags for, 5-58 
specifying formats for, 5-57 
specifying private data for, 5-57 
Tables 
See Table definition 
See Table metadata 
Table window aggregate, 5-66 to 5-68 
active location item in, 5~67 
cardinal number item in, 5-67 
flags item in, 5-67 
format item in, 5-67 
items in, 5-66 
private window data item in, 5-66 
ranges item in, 5-67 
window descriptor item in, 5-67 
window identifier item in, 5-66 
window name item in, 5-66 
Table windows 
referencing from format information, 5-30 
specifying a cardinal number for, 5-67 
specifying a descriptor item for, 5-67 
specifying a window identifier for, 5-66 
specifying a window name for, 5-66 
specifying flags for, 5-67 
specifying formats for, 5-67 
specifying private data for, 5—66 
specifying ranges in, 5-67 
specifying the active or current cell in, 5-67 
specifying within table definition, 5-61 
Tab stop 
specifying horizontal position of, 4-160 
specifying leader character for, 4-161 
specifying type of alignment for, 4-161 
Tab stop aggregate, 4-160 to 4-161 
See also DDIF$_TBS aggregate 
items in, 4-160t 
tab stop horizontal position indicator item in, 4-160 
tab stop leader item in, 4-161 
tab stop type item in, 4-161 
TabStopList syntax diagram, B-—43 
TabStop syntax diagram, B-43 
Tag 
See File tag 
Tags 
See ESF edit strings 


Tags (Cont.) 
$AN, 4-91 
content categories, 1-8 
content processing characteristics, 1-8 
content streams in layout, 1-9 
$CRF, 4-91 
$2D, 4-90 
$DB, 4-30, 4-90 
$E, 4-91 
$EN, 4-30, 4-90 
$F, 4-91 
$FN, 4—30, 4-90, 4-91 
$GO, 4-91 
$GRP, 4-91 
$l, 4-90, 4-91 
$IX, 4-30, 4-90 
$L, 4-91 
$LBL, 4-91 
$LE, 4-91 
$LIT, 4-91 
$MN, 4-30, 4-90 
$P, 4-91 
$PDL, 4-90 
$S, 4-91 
See Edit string aggregate, 7-4 
$T, 4-90 
$TBL, 4-90 
$TOC, 4-30, 4-90 
$TTL, 4-91 
Tag syntax diagram, B-35 
Tangent construct 
See ExpressionList syntax diagram and CFE 
expressions, trigonometric 
Tan syntax diagram 
See ExpressionList syntax diagram 
$TBL tag, defined, 4-90 
Text 
controlling kerning for, 4-127 
specifying alignment characters for, 4-125 
specifying amount of space used by the leader 
character in, 4—126 
specifying attributes for, 4-118 to 4-127 
specifying format of lines wrapped by the formatter, 
4-55 
specifying format of lines wrapped by the user, 
4—55 
specifying leader alignment in, 4-126 
specifying maximum consecutive hyphenated lines 
of, 4-56 
specifying maximum orphan size of, 4-56 
specifying maximum widow size of, 4-56 
specifying one or more renditions for, 4-121 
specifying pattern and color of glyphs in, 4-119 
specifying rules that affect hyphenation of, 4-55 
specifying string used to fill leader space in, 4-126 
specifying the direction of characters in, 4-124 
specifying the font used for, 4-120 
specifying the height of, 4-123 
specifying the ratio for character widths in, 4-123 
specifying type of leader to use in, 4-126 
Text attribute, 4-118 
TextAttributes syntax diagram, B-7 
Text back end, 2-4 to 2-5 
conversion restrictions, 2—4 
data mapping in, 2-4 
processing options in, 2-4 
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Text choice aggregate, 6-64 

items in, 6-64 

text type indicator item in, 6-64 
Text content 

general, 4~32 

Latini, 4-164 

specifying general character set for, 4-32 

specifying Latin1 character set for, 4-164 
Text content aggregate 

See also DDIF$_TXT aggregate 

item in, 4-164 
Text discard option, 1-17 
$TEXT editstring-name, 5-49 
Text file 

closing, 8-11 

creating, 8-54 

opening, 8-141 

reading a line from, 8-156 

returning position in, 8-106 

returning size of, 8-106 

writing a line to, 8-168 
TextFmt syntax diagram, C—13 
Text front end, 2-2 to 2-3 

conversion restrictions, 2-3 

data mapping in, 2-2 

document syntax errors in, 2-3 

external file references in, 2-3 
Text kerning, 4-127 
TextLayout syntax diagram, B-9 
Text-position layout, 4-102 
TextPrimitive syntax diagram, B~7 
Text string aggregate, 7-27 

items in, 7-27 

text string item in, 7-27 
Text-string construct 

See ExpressionList syntax diagram and CFE 

expressions, literals 

Text-String defined type, defined, B-4 
Text-String syntax diagram, B-5 
$TIME edit-string name, 5-49 
$TOC tag, defined, 4-30, 4-90 
Today construct 


See ExpressionList syntax diagram and CFE 
expressions, date/time literals 
Tomorrow construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time literals 
Transferring CDA documents, 3-1 
Transformation 
returning information about, 8-83 
specifying type of parameter specified for, 4—163 
specifying value of the parameter for, 4-163 
Transformation aggregate, 4-162 to 4-163 


See also DDIF$_TRN aggregate 
items in, 4-162 
transformation parameter indicator item in, 4-163 
Transformation syntax diagram, B-36 
Trend construct 
See ExpressionList syntax diagram and CFE 
expressions, series 
True construct 
See ExpressionList syntax diagram and CFE 
expressions, variables 
Truncate construct 
See ExpressionList syntax diagram and CFE 
expressions, conversion 
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$T tag, defined, 4-90 
$TTL tag, defined, 4-91 
TXT 
See Text 
Type definition 
specifying parent for, 4-165 
specifying private data for, 4-166 
specifying reference label for, 4-165 
specifying segment attributes for, 4-165 
Type definition aggregate, 4-165 to 4-166 
See also DDIF$_TYD aggregate 
attributes item in, 4-165 
items in, 4-165t 
label item in, 4-165 
parent item in, 4-165 
private data item in, 4-166 
Type definitions, 1-14 
Type references, 1-14 


U 


ULTRIX commands 
cdoc, 2-16 
dxvdoc, 2-18 
vdoc, 2-20 
Unary-plus construct 
See ExpressionList syntax diagram and CFE 
expressions, arithmetic 
User routines 
Allocate/Deallocate, 9-2 
Flush, 9-4 
Get, 9-6, 9-7 
Get-position, 9-8 
Put routine, 9-10 


V 


ValueData syntax diagram, B-28, C—-15 
ValueDirective syntax diagram, B—10 
Variable 

encoding of, 1-4 
Variable computed content, 4-94 
VariableLabel syntax diagram, B-24, B-25 
VariableReset syntax diagram, B—-11 
Variance construct 

See ExpressionList syntax diagram and CFE 

expressions, statistical 

Var syntax diagram 

See ExpressionList syntax diagram 
Varying length text construct 


See ExpressionList syntax diagram and CFE 
expressions, literals 
Varying text aggregate 


See CFE varying text aggregate 


See DTIF varying text aggregate 
VaryingText syntax diagram, C-7 
vdoc command, 2-20 to 2-21 

-f format qualifier, 2-20 

-h paper-height qualifier, 2-21 

-O options qualifier, 2-21 

-p qualifier, 2-21 

-r qualitifer, 2-21 

-w paper-width qualifier, 2-21 
VIEW command, 2-13 to 2-15 

/FORMAT qualifier, 2-13 


VIEW command (Cont.) 
/INTERFACE qualifier, 2-14 
/[NOJOUTPUT qualifier, 2-14 
/[NOJOVERRIDE_FORMAT qualifier, 2-14 
/[NO]PAGE qualifier, 2-14 
/OPTIONS qualifier, 2-14 
/WIDTH qualifier, 2-14 
Viewer images 
linking on ULTRIX, 13-2 
linking on VMS, 13-2 
Viookup construct 
See ExpressionList syntax diagram and CFE 
expressions, choose and lookup 
VMS 
support for CDA in, F-1 
VMS commands 
CONVERT/DOCUMENT, 2-11 
VIEW, 2-13 


W 


WIDTH qualifier 

for the VIEW command, 2-14 
WindowDefn syntax diagram, C-5 
Windows 

See Table windows 


-w paper-width qualifier 
for the dxvdoc command, 2-19 
for the vdoc command, 2-21 
Wrap attributes aggregate, 4-54 to 4-56 
See also DDIF$_LW1 aggregate 
hyphenation flags item in, 4-55 
hyphenation lines item in, 4-56 
items in, 4—54t 
maximum orphan size item in, 4-56 
maximum widow size item in, 4-56 
quad format item in, 4-55 
wrap format item in, 4-55 
WrapAttributes syntax diagram, B-41 
WRITE TEXT FILE routine, 8-168 


X 


XCoordinate syntax diagram, B-27 
XRF 
See Cross-reference computed content 


Y 


YCoordinate syntax diagram, B-28 
Yesterday construct 
See ExpressionList syntax diagram and CFE 
expressions, date/time literals 
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If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 


Continental USA, 
Alaska, or Hawaii 


Puerto Rico 


Canada 


International 


Internal! 
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800-DIGITAL 


809-754-7575 
800-267-6215 
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Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local Digital subsidiary or 
approved distributor 


USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1¥or internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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